List appointments
List appointments by status, technician, job or time window.
GET https://cotlet.dev/api/v1/servicetrade/appointments
read
Returns each appointment with its status, window, job, location, technicians and whether it is released. Use it to see who is free before booking, or to find drafts to release.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | One or more of scheduled, unscheduled, canceled_by_vendor, canceled_by_customer, completed, no_show, comma-separated. |
| job_id integer | integer | Only appointments of this job. |
| technician_id integer | integer | Only appointments for this technician. |
| window_from string | string | ISO 8601 date or date-time; only appointments whose window starts on or after it. |
| window_to string | string | ISO 8601 date or date-time; only appointments whose window starts on or before it. |
| released boolean | boolean | true for appointments released to technicians, false for drafts. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/servicetrade/appointments \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("servicetrade", "list_appointments")const result = await cotlet.call('servicetrade', 'list_appointments');cotlet call servicetrade list_appointmentsExample response
{
"appointments": [
{
"id": 90388,
"status": "scheduled",
"window_start": "2026-10-26T08:00:00-04:00",
"window_end": "2026-10-26T11:00:00-04:00",
"job": {
"id": 48190,
"name": "Sprinkler inspection"
},
"location": {
"id": 5133,
"name": "Delta Plaza"
},
"technicians": [
{
"id": 3302,
"name": "Dana Ruiz"
}
],
"released": false
}
],
"next_cursor": null
}