List appointments
List appointments by status, technician, job or time window.
MCP tool servicetrade_read → list_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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "servicetrade_read",
"arguments": {
"operation": "list_appointments",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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
},
"isError": false
}