REST API
Instructors API
Use the Sky Schedule instructors API to list and fetch the flight instructors at your school, with each CFI's name, email, phone, and active or inactive status.
The instructors API returns the flight instructors at your school, with each CFI's name, email, phone number, and whether they are active. Use it to keep a staff directory, a payroll sheet, or an on-call list in step with Sky Schedule.
| Method and path | Description |
|---|---|
GET/api/v1/instructors | List instructors |
GET/api/v1/instructors/{id} | Get one instructor by id |
The instructor object
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Instructor id. |
name | string or null | Full name. |
email | string or null | Email address. |
phone | string or null | Phone number as entered. |
status | string | active or inactive. |
List instructors
GET https://app.skyschedule.io/api/v1/instructors
Query parameters
| Parameter | Required | Description |
|---|---|---|
limit | No | Records to return, 1 to 100. Default 50. |
Instructors are sorted by name, A to Z, and both active and inactive instructors are included. Filter on status if you only want current staff.
Example request
curl -s "https://app.skyschedule.io/api/v1/instructors" \
-H "Authorization: Bearer $SKYSCHEDULE_API_KEY"
Example response
{
"data": [
{
"id": "66666666-6666-4666-8666-666666666666",
"name": "Jordan Instructor",
"email": "jordan.cfi@example.com",
"phone": "555-0102",
"status": "inactive"
},
{
"id": "77777777-7777-4777-8777-777777777777",
"name": "Sam Instructor",
"email": "sam.cfi@example.com",
"phone": "555-0101",
"status": "active"
}
],
"meta": {
"count": 2,
"pageSize": 50,
"rateLimit": { "limit": 100, "remaining": 91, "reset": "2026-10-09T00:00:00.000Z" }
}
}
Get one instructor
GET https://app.skyschedule.io/api/v1/instructors/{id}
curl -s "https://app.skyschedule.io/api/v1/instructors/77777777-7777-4777-8777-777777777777" \
-H "Authorization: Bearer $SKYSCHEDULE_API_KEY"
{
"data": {
"id": "77777777-7777-4777-8777-777777777777",
"name": "Sam Instructor",
"email": "sam.cfi@example.com",
"phone": "555-0101",
"status": "active"
},
"meta": {
"rateLimit": { "limit": 100, "remaining": 90, "reset": "2026-10-09T00:00:00.000Z" }
}
}
An id that doesn't exist in your school returns 404 with { "error": "Instructor not found." }.
Matching instructors to reservations and flights
Reservations list up to two instructors in people, and completed flights include the primary instructor. Neither includes the instructor id, so match on email. Like the customers API, this list holds personal information, so keep your key private.