Get Work Orders

Changed on

Operates on Service Orders, shown in the Zuper client app as "Work Order" (in every industry). Work Orders share the exact same underlying schema and endpoints as Purchase Orders / Material Orders; they're distinguished only by the purchase_order_type field (SERVICE_ORDER here) and the /service_orders route prefix. purchase_order_type is always enforced server-side based on this route; you cannot use this endpoint to read the other module's records.

get/service_orders

Request

  • Base URL
    https://dc-region.zuperpro.com/api
  • URL
    https://dc-region.zuperpro.com/api/service_orders
  • Auth
    API key in header x-api-key

Query parameters

filter.keywordstring
filter.is_activestring
filter.vendorstring

vendor_uid

filter.created_from_datestring date
filter.created_to_datestring date
filter.due_from_datestring date
filter.due_to_datestring date
filter.purchase_order_from_datestring date
filter.purchase_order_to_datestring date
filter.created_bystring

user uid

filter.statusstring
filter.updated_at_fromstring date
filter.updated_at_tostring date
filter.jobstring

Job uid

filter.estimatestring

Quote uid

filter.reference_numberstring
filter.purchase_order_numberstring
filter.await_approval_fromstring
filter.purchase_order_uidstring
pagestring

Default "1".

limitstring

Default "10". Also accepts count as an alias.

sortstring

"ASC" or "DESC", default "DESC" (by created_at).

cursorstring

Opaque cursor for cursor-based pagination.

prev_cursorstring

Opaque cursor for the previous page.

cursor_paginationstring

Set to enable cursor-based pagination instead of offset pagination.

include_deletedstring

Set to include soft-deleted records.

fields_to_selectstring

Sparse fieldset selector.

filter.projectstring

Project UID.

filter.assetstring

Asset UID.

filter.material_requeststring

Material Request UID.

filter.appointment_uidstring

Comma-separated appointment UIDs.

filter.parent_postring
filter.current_delivery_statusstring
filter.supplier_order_refstring
filter.delivery_methodstring

Response

200

type'success'
messagestring
dataobject[]
total_recordsinteger
current_pageinteger
total_pagesinteger

Changes