REST API

Reservation Comments API

Use the Sky Schedule reservation comments API to list notes left on flights, meeting rooms, ground lessons, and other bookings, newest first or for one booking.

llms.txt

The reservation comments API returns the comments people leave on bookings in Sky Schedule, such as a lesson plan for the flight or a fuel request for the line crew. It covers comments on flight reservations and on the school's other schedule rows: meeting rooms, ground lessons, instructor activities, and other rows such as classrooms.

GET https://app.skyschedule.io/api/v1/comments

Query parameters

ParameterRequiredDescription
reservationIdNoFull UUID of one booking. Returns only that booking's comments.
limitNoRecords to return, 1 to 100. Default 50.

Comments from every kind of booking are merged and sorted newest first, and limit applies to the merged list. reservationId must be a complete UUID; a partial id can fail with 500 instead of returning an empty list.

The comment object

FieldTypeDescription
idstring (UUID)Comment id.
reservationIdstring or nullThe booking the comment belongs to.
kindstringWhich kind of booking: flight, meeting_room, ground_training, instructor_activity, or misc_row (another schedule row, such as a classroom).
authorstring or nullFirst name of the person who wrote it.
textstring or nullThe comment.
createdAtstring or nullWhen it was posted, ISO 8601 with UTC offset.

For flight comments, reservationId is the id you get from the reservations API. The other kinds point to meeting room, ground lesson, and other bookings, which have no REST endpoint of their own.

Example: comments on one reservation

curl -s "https://app.skyschedule.io/api/v1/comments?reservationId=11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer $SKYSCHEDULE_API_KEY"

{
  "data": [
    {
      "id": "eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee",
      "reservationId": "11111111-1111-4111-8111-111111111111",
      "kind": "flight",
      "author": "Sam",
      "text": "Plan on pattern work at KSEE. Bring your logbook for the endorsement.",
      "createdAt": "2026-10-08T16:40:12.207+00:00"
    }
  ],
  "meta": {
    "count": 1,
    "pageSize": 50,
    "rateLimit": { "limit": 100, "remaining": 84, "reset": "2026-10-09T00:00:00.000Z" }
  }
}

Example: latest comments across the schedule

curl -s "https://app.skyschedule.io/api/v1/comments?limit=20" \
  -H "Authorization: Bearer $SKYSCHEDULE_API_KEY"

Agents can read the same data with the MCP tool list_reservation_comments; see the MCP tools reference. For limits and error codes, see rate limits and errors.

PreviousMaintenanceNextMCP server