API ReferenceWork Orders

List Project Work Orders

Retrieve work orders for a specific project. Supports: - Pagination (`page_size`, `page`) - Date filtering (`updated_after`, `updated_before`) - Sorting (`order_by`)

Authentication

x-api-keystring
API Key authentication via header

Path parameters

projectIdintegerRequired
Project identifier

Query parameters

page_sizeintegerOptional1-100Defaults to 20

Number of items per page (max 100)

pageintegerOptional>=1Defaults to 1

Page number (1-based)

updated_afterstringOptionalformat: "date-time"

Filter items updated after this timestamp (ISO 8601)

updated_beforestringOptionalformat: "date-time"

Filter items updated before this timestamp (ISO 8601)

order_byenumOptionalDefaults to asc
Sort order for results
Allowed values:

Response

List of work orders
idinteger
Work order identifier
uidinteger
Unique work order number within the project
templateIdinteger
Template identifier for the work order
createdAtstringformat: "date-time"
Creation timestamp
updatedAtstringformat: "date-time"
Last update timestamp
titlestring
Work order title
descriptionstring
Work order description
priorityinteger
Priority level
startDatestring or nullformat: "date-time"
Scheduled start date
startDateAllDayboolean

Whether the start date is an all-day event

endDatestring or nullformat: "date-time"
Scheduled end date
endDateAllDayboolean

Whether the end date is an all-day event

completedAtstring or nullformat: "date-time"
Timestamp when the work order was completed
isArchivedboolean
Whether the work order is archived
isCompletedboolean
Whether the work order is completed
isFieldboolean
Whether the work order is a field task
labelslist of objects
Labels associated with the work order
projectobject
Project associated with the work order
assigneeobject or null
User assigned to the work order
collaboratorslist of objects
Additional users collaborating on the work order
visitsobject

Site visits associated with the work order (legacy shape)

statuseslist of objects
History of status changes and time spent in each status
statusobject or null
Current status of the work order
checklistlist of objects
Checklist items for the work order
workItemslist of objects

Work items linked to this work order via Blueprint workflow. Includes forms (FORM) and file requests (FILE_REQUEST). Returns [] when none are linked.

lineItemslist of objects

Present only for service work orders on an account (parent project type ACCOUNT), and only when at least one line item exists. Amounts are in dollars with cent precision. Replace via PUT /work-orders/{workOrderId}/line-items. Omitted from the response when not applicable or when there are no line items.

Errors

401
Unauthorized Error
404
Not Found Error