List job requests
listJobRequestsRead-only
Retrieve a paginated list of work orders with filters for status, technician, schedule, and customer. Use date ranges and technician ID to view team or individual agendas.
Instructions
List job requests
Paginated list of the business's bookings (work orders) with dispatch-oriented filters: workflow status, customer, assigned technician, scheduled date range and free-text search over code/description. This is also the SCHEDULE query: combine technician_id + scheduled_from/scheduled_to to read one technician's agenda for a day or week (e.g. "what is Alex doing tomorrow"), or just the date range for the whole team's calendar.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search short_code or description (case-insensitive, partial match) | |
| page | No | Page number | |
| sort | No | Sort key: created_at:desc (default) | created_at:asc | scheduled_at:asc | scheduled_at:desc | priority:asc (P0 first) | priority:desc | |
| limit | No | Page size | |
| status | No | active (default) | archived | all | |
| priority | No | Priority filter (p0|p1|p2|p3) | |
| customer_id | No | Customer UUID | |
| status_keys | No | Comma-separated status slugs | |
| completed_to | No | Filter by completion time to (YYYY-MM-DD = end of that day in the business timezone, or RFC3339), exclusive | |
| scheduled_to | No | Filter to (YYYY-MM-DD = end of that day in the business timezone, or RFC3339), exclusive | |
| technician_id | No | Technician UUID | |
| completed_from | No | Filter by completion time from (YYYY-MM-DD = start of that day in the business timezone, or RFC3339); range is [from, to). Counts jobs by when they were completed regardless of reschedules. | |
| scheduled_from | No | Filter from (YYYY-MM-DD = start of that day in the business timezone, or RFC3339); range is [from, to) | |
| service_area_id | No | Service-area UUID (board zone filter) |