List jobs
List jobs filtered by status, location, customer, technician or due date.
GET https://cotlet.dev/api/v1/servicetrade/jobs
read
Returns the job number, name, type, status, location, customer and due date, and the number of services still open. The agent sorts by due date itself. A job with status new is shown by ServiceTrade as Unscheduled. What you see follows your role in ServiceTrade.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | One or more of new (shown as Unscheduled), scheduled, canceled, bidding, completed, pending_invoice, sending_invoice, invoiced, closed, comma-separated. |
| location_id integer | integer | Only jobs at this location, from list_locations. |
| customer_id integer | integer | Only jobs for this customer company. |
| technician_id integer | integer | Only jobs with an appointment for this technician, from list_technicians. |
| due_by_before string | string | ISO 8601 date or date-time; only jobs due on or before it. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/servicetrade/jobs \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("servicetrade", "list_jobs")const result = await cotlet.call('servicetrade', 'list_jobs');cotlet call servicetrade list_jobsExample response
{
"jobs": [
{
"id": 48213,
"number": 1042,
"name": "Fire pump test",
"type": "planned_maintenance",
"status": "new",
"display_status": "Unscheduled",
"location": {
"id": 5120,
"name": "Harbor Point Mall"
},
"customer": {
"id": 2211,
"name": "Harbor Point Properties"
},
"due_by": "2026-10-30",
"open_services": 2
}
],
"next_cursor": null
}