List Work Orders
Returns a list of work orders.
Query Parameters
- start_cursor string
The start cursor for Keyset pagination.
- per_page integer
Possible values:
>= 2
and<= 100
Default value:
50
The number of records per page to return
- filter object
The fields, operations, and values to filter the records by.
contact_id object
eq string requiredcreated_by_id object
eq string requiredissued_by_id object
eq string requiredvehicle_id object
eq string requiredvendor_id object
eq string requiredvmrs_repair_priority_class_id object
eq string requiredpurchase_order_number object
oneOf- MOD1
- MOD2
like string requiredeq string requiredinvoice_number object
oneOf- MOD1
- MOD2
like string requiredeq string requirednumber object
eq string requiredlabels object
include string requiredwork_order_status_name object
include string requiredcreated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string requiredupdated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string required
- sort object
The fields and direction to sort the results by.
- created_at string
Possible values: [
asc
,desc
] - updated_at string
Possible values: [
asc
,desc
] - id string
Possible values: [
asc
,desc
]Default value:
desc
- 200
- 400
- 401
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
- start_cursor string
The current start cursor of the records returned.
- next_cursor string
The next cursor to retrieve the next page of records.
- per_page integer
The maxumum number of records returned.
- estimated_remaining_count integer
The number of remaining records including the returned records, up to a maximum of 500.
filtered_by object[]
The filters applied to the returned record set.
anyOf- MOD1
- MOD2
- MOD3
- MOD4
- MOD5
- MOD6
- MOD7
- MOD8
- MOD9
- MOD10
- MOD11
- MOD12
contact_id object
eq stringcreated_by_id object
eq stringissued_by_id object
eq stringvehicle_id object
eq stringvendor_id object
eq stringvmrs_repair_priority_class_id object
eq stringpurchase_order_number object
oneOf- MOD1
- MOD2
like stringeq stringinvoice_number object
oneOf- MOD1
- MOD2
like stringeq stringnumber object
eq stringlabels object
include stringcreated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringupdated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringsorted_by object[]
The sorts applied to the returned record set.
anyOf- MOD1
- MOD2
- MOD3
created_at stringPossible values: [
asc
,desc
]updated_at stringPossible values: [
asc
,desc
]id stringPossible values: [
asc
,desc
]records object[]
id integernumber stringThe unique number of this Work Order.
completed_at date-timeThe date and time at which the Work Order was completed.
description stringA description of this Work Order.
ending_meter_same_as_start booleanIndicates whether or not the ending meter is the same as the starting meter.
duration_in_seconds integerThe number of seconds elapsed between beginning this Work Order and completing it.
invoice_number stringThe number of the
Invoice
associated with this Work Order.state stringPossible values: [
active
,completed
]Indicates whether this Work Order is currently active or has already been completed.
issued_at date-timeThe date and time at which the Work Order was issued.
issued_by_id integerThe id of the issuer of this Work Order.
contact_id integerThe id of the
Contact
assigned to this Work Order.purchase_order_number stringThe purchase order number for this Work Order.
scheduled_at date-timeThe date and time at which the Work Order was scheduled.
started_at date-timeThe date and time at which the Work Order was started.
expected_completed_at date-timeThe date and time at which the Work Order is expected to be completed.
vehicle_id integerThe id of the
Vehicle
associated with this Work Order.work_order_status_id integerThe id of the
WorkOrderStatus
for this Work Order.work_order_status_color stringThe color of the
Work Order Status
for this Work Order.work_order_status_name stringThe name of the
Work Order Status
for this Work Order.documents_count integerThe count of associated documents.
images_count integerThe count of the associated images.
comments_count integerThe count of associated comments.
created_at date-timeThe date and time at which the Work Order was created.
updated_at date-timeThe date and time at which the Work Order was last updated.
labor_time_in_seconds integerThe sum, in seconds, of the duration of all labor line items of a
completed
Work Order.attachment_permissions object
read_photos booleanIndicates whether the user has read permission for photos.
manage_photos booleanIndicates whether the user has permission to manage (eg. upload, delete) photos.
read_documents booleanIndicates whether the user has read permission for documents.
manage_documents booleanIndicates whether the user has permission to manage (eg. upload, delete) documents.
custom_fields object*Full details on working with Custom Fields here.
contact object
A Contact
id integeremail stringThe Contact's email address.
name stringThe Contact's full name.
group_id integerIf this Contact belongs to a Group, this will be the Fleetio ID of that
Group
.default_image_url stringThe URL of the Contact's default image/profile photo, if any.
vehicle object
A Vehicle
id integername stringThis vehicle's name.
color stringThe color of this Vehicle.
license_plate stringThe license plate number of this Vehicle.
vin stringThe Vehicle Identification Number of this Vehicle.
year stringThis Vehicle's model year.
make stringThe name of this Vehicle's manufacturer.
model stringThe name of the model of this Vehicle.
trim stringThe trim level of this Vehicle.
registration_expiration_month integerPossible values:
<= 12
The month in which this Vehicle's registration expires.
registration_state stringThe state, province, or territory in which this Vehicle is registered.
default_image_url_small stringThe URL of a small-sized version of the default image for this Vehicle.
vendor object
A Vendor
name stringThe name of the Vendor.
phone stringThe phone number of the Vendor.
city stringThe city of the Vendor.
region stringThe region, state, province, or territory of the Vendor.
postal_code stringThe postal code or ZIP code of the Vendor.
country stringThe country of the Vendor.
external_id stringThe external identifier of the Vendor.
{
"start_cursor": "string",
"next_cursor": "string",
"per_page": 0,
"estimated_remaining_count": 0,
"filtered_by": [
{
"contact_id": {
"eq": "string"
}
},
{
"created_by_id": {
"eq": "string"
}
},
{
"issued_by_id": {
"eq": "string"
}
},
{
"vehicle_id": {
"eq": "string"
}
},
{
"vendor_id": {
"eq": "string"
}
},
{
"vmrs_repair_priority_class_id": {
"eq": "string"
}
},
{
"purchase_order_number": {
"like": "string"
}
},
{
"invoice_number": {
"like": "string"
}
},
{
"number": {
"eq": "string"
}
},
{
"labels": {
"include": "string"
}
},
{
"created_at": {
"lt": "string"
}
},
{
"updated_at": {
"lt": "string"
}
}
],
"sorted_by": [
{
"created_at": "asc"
},
{
"updated_at": "asc"
},
{
"id": "asc"
}
],
"records": [
{
"id": 0,
"number": "string",
"completed_at": "2023-03-14T13:46:27-06:00",
"description": "string",
"ending_meter_same_as_start": true,
"duration_in_seconds": 0,
"invoice_number": "string",
"state": "active",
"issued_at": "2023-03-14T13:46:27-06:00",
"issued_by_id": 0,
"contact_id": 0,
"purchase_order_number": "string",
"scheduled_at": "2023-03-14T13:46:27-06:00",
"started_at": "2023-03-14T13:46:27-06:00",
"expected_completed_at": "2023-03-14T13:46:27-06:00",
"vehicle_id": 0,
"work_order_status_id": 0,
"work_order_status_color": "string",
"work_order_status_name": "string",
"documents_count": 0,
"images_count": 0,
"comments_count": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"labor_time_in_seconds": 0,
"attachment_permissions": {
"read_photos": true,
"manage_photos": true,
"read_documents": true,
"manage_documents": true
},
"custom_fields": {},
"contact": {
"id": 0,
"email": "string",
"name": "string",
"group_id": 0,
"default_image_url": "string"
},
"vehicle": {
"id": 0,
"name": "string",
"color": "string",
"license_plate": "string",
"vin": "string",
"year": "string",
"make": "string",
"model": "string",
"trim": "string",
"registration_expiration_month": 0,
"registration_state": "string",
"default_image_url_small": "string"
},
"vendor": {
"name": "string",
"phone": "string",
"city": "string",
"region": "string",
"postal_code": "string",
"country": "string",
"external_id": "string"
}
}
]
}
The format or parameters of the request was invalid
- application/json
- Schema
- Example (from schema)
Schema
errors object
typeitems string
{
"errors": {}
}
Request could not be authenticated
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Something unexpected happened
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}