dispatch_jobs_list
Retrieve and filter dispatched jobs from ServiceTitan using criteria like status, priority, technician, customer, and appointment dates to manage field service operations.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort: Field (default), +Field (asc), or -Field (desc). Fields: Id, ModifiedOn, CreatedOn, Priority | |
| ids | No | Comma-separated job IDs (maximum 50) | |
| number | No | Filter by job number | |
| projectId | No | Filter by project ID | |
| bookingId | No | Filter by booking ID | |
| jobStatus | No | Job status filter | |
| appointmentStatus | No | Appointment status filter | |
| priority | No | Job priority filter | |
| firstAppointmentStartsOnOrAfter | No | Return jobs whose first appointment starts on or after this UTC timestamp | |
| firstAppointmentStartsBefore | No | Return jobs whose first appointment starts before this UTC timestamp | |
| appointmentStartsOnOrAfter | No | Return jobs with any appointment on or after this UTC timestamp | |
| appointmentStartsBefore | No | Return jobs with any appointment before this UTC timestamp | |
| technicianId | No | Filter by technician ID | |
| customerId | No | Filter by customer ID | |
| locationId | No | Filter by location ID | |
| soldById | No | Filter by selling technician ID | |
| jobTypeId | No | Filter by job type ID | |
| campaignId | No | Filter by campaign ID | |
| businessUnitId | No | Filter by business unit ID | |
| invoiceId | No | Filter by invoice ID | |
| completedOnOrAfter | No | Return jobs completed on or after this UTC timestamp | |
| completedBefore | No | Return jobs completed before this UTC timestamp | |
| tagTypeIds | No | Comma-separated tag type IDs | |
| externalDataApplicationGuid | No | External data application GUID | |
| externalDataKey | No | External data key | |
| externalDataValues | No | External data values (comma-separated, maximum 50) | |
| hasUnusedAppointments | No | Return jobs with unused appointments | |
| createdBefore | No | Return items created before this UTC timestamp | |
| createdOnOrAfter | No | Return items created on or after this UTC timestamp | |
| modifiedBefore | No | Return items modified before this UTC timestamp | |
| modifiedOnOrAfter | No | Return items modified on or after this UTC timestamp | |
| page | No | Page number (starts at 1) | |
| pageSize | No | Records per page (default 50) | |
| includeTotal | No | Include total count in response |