List Service Entries
Returns a list of Service Entries belonging to your account.
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.
reference object
oneOf- MOD1
- MOD2
like string requiredeq string requiredstatus object
include string requiredlabels object
include string requiredcompleted_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte 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.
- id string
Possible values: [
asc
,desc
]Default value:
desc
- completed_at string
Possible values: [
asc
,desc
] - updated_at string
Possible values: [
asc
,desc
] - created_at string
Possible values: [
asc
,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
reference object
oneOf- MOD1
- MOD2
like stringeq stringstatus object
include stringlabels object
include stringcompleted_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte 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
- MOD4
completed_at stringPossible values: [
asc
,desc
]updated_at stringPossible values: [
asc
,desc
]created_at stringPossible values: [
asc
,desc
]id stringPossible values: [
asc
,desc
]records object[]
id integercompleted_at date-timeThe date and time at which the Service Entry was completed.
reference stringA reference number for this Service Entry.
started_at date-timeThe date and time at which the Service Entry was started.
status stringPossible values: [
pending
,completed
]The status of this Service Entry.
general_notes stringGeneral notes for this Service Entry.
vehicle_id integervendor_id integerwork_order_id integeris_sample booleanIndicates whether or not this Service Entry is a sample. Sample Service Entries are not included in reports.
primary_meter_entry object
A Meter Entry
id integercreated_at date-timeupdated_at date-timeauto_voided_at date-timeThe date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in
User
's local time.category stringPossible values: [
starting
,ending
,nightly
,manual
]A category to describe the function of this Meter Entry.
meter_type stringPossible values: [
secondary
]Indicates whether or not this Meter is a secondary Meter.
meterable_id NullableIdPossible values:
>= 1
meterable_type stringPossible values: [
FuelEntry
,Issue
,PurchaseDetail
,ServiceEntry
,SubmittedInspectionItem
,VehicleAssignment
,WorkOrder
]The type of the object with which this Meter Entry is associated.
value stringThe current value of the meter.
vehicle_id NullableIdPossible values:
>= 1
void booleanDefault value:
false
Indicates whether or not this Meter Entry has been voided.
type stringPossible values: [
GpsMeterEntry
]date dateThe date on which this Meter Entry was recorded. Formatted according to ISO-8601.
secondary_meter_entry object
A Meter Entry
id integercreated_at date-timeupdated_at date-timeauto_voided_at date-timeThe date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in
User
's local time.category stringPossible values: [
starting
,ending
,nightly
,manual
]A category to describe the function of this Meter Entry.
meter_type stringPossible values: [
secondary
]Indicates whether or not this Meter is a secondary Meter.
meterable_id NullableIdPossible values:
>= 1
meterable_type stringPossible values: [
FuelEntry
,Issue
,PurchaseDetail
,ServiceEntry
,SubmittedInspectionItem
,VehicleAssignment
,WorkOrder
]The type of the object with which this Meter Entry is associated.
value stringThe current value of the meter.
vehicle_id NullableIdPossible values:
>= 1
void booleanDefault value:
false
Indicates whether or not this Meter Entry has been voided.
type stringPossible values: [
GpsMeterEntry
]date dateThe date on which this Meter Entry was recorded. Formatted according to ISO-8601.
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.
labels object[]
id integerPossible values:
>= 1
name stringvendor 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.
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.
discount_type DiscountTypePossible values: [
fixed
,percentage
]Default value:
percentage
The type of discount applied to this record.
discount_percentage stringThe discount percentage. This field should be present when
discount_type
is set topercentage
.tax_1_type stringThe primary tax type.
tax_1_percentage stringThe primary tax percentage.
tax_2_type stringThe secondary tax type.
tax_2_percentage stringThe secondary tax percentage.
labor_subtotal_cents integerThe pre-tax subtotal amount for labor.
parts_subtotal_cents integerThe pre-tax subtotal amount for parts.
fees_cents integerThe fees amount. This is the sum of any
ServiceEntryFeeLineItem
s present.subtotal_cents integerThe pre-tax subtotal amount.
discount_cents integerThe discount amount.
tax_1_cents integerThe primary tax amount.
tax_2_cents integerThe secondary tax amount.
total_amount_cents integerThe total amount.
labor_time_in_seconds integerThe sum, in seconds, of the duration of all labor line items of the Work Order that created this Service Entry, if applicable. This field is only relevant when the Service Entry is created from a Work Order.
{
"start_cursor": "string",
"next_cursor": "string",
"per_page": 0,
"estimated_remaining_count": 0,
"filtered_by": [
{
"reference": {
"like": "string"
}
},
{
"status": {
"include": "string"
}
},
{
"labels": {
"include": "string"
}
},
{
"completed_at": {
"lt": "string"
}
},
{
"created_at": {
"lt": "string"
}
},
{
"updated_at": {
"lt": "string"
}
}
],
"sorted_by": [
{
"completed_at": "asc"
},
{
"updated_at": "asc"
},
{
"created_at": "asc"
},
{
"id": "asc"
}
],
"records": [
{
"id": 0,
"completed_at": "2023-03-14T13:46:27-06:00",
"reference": "string",
"started_at": "2023-03-14T13:46:27-06:00",
"status": "pending",
"general_notes": "string",
"vehicle_id": 0,
"vendor_id": 0,
"work_order_id": 0,
"is_sample": true,
"primary_meter_entry": {
"id": 0,
"created_at": "2024-11-21",
"updated_at": "2024-11-21",
"auto_voided_at": "2023-03-14T13:46:27-06:00",
"category": "starting",
"meter_type": "secondary",
"meterable_id": 0,
"meterable_type": "FuelEntry",
"value": "string",
"vehicle_id": 0,
"void": false,
"type": "GpsMeterEntry",
"date": "2023-03-14"
},
"secondary_meter_entry": {
"id": 0,
"created_at": "2024-11-21",
"updated_at": "2024-11-21",
"auto_voided_at": "2023-03-14T13:46:27-06:00",
"category": "starting",
"meter_type": "secondary",
"meterable_id": 0,
"meterable_type": "FuelEntry",
"value": "string",
"vehicle_id": 0,
"void": false,
"type": "GpsMeterEntry",
"date": "2023-03-14"
},
"attachment_permissions": {
"read_photos": true,
"manage_photos": true,
"read_documents": true,
"manage_documents": true
},
"custom_fields": {},
"labels": [
{
"id": 0,
"name": "string"
}
],
"vendor": {
"name": "string",
"phone": "string",
"city": "string",
"region": "string",
"postal_code": "string",
"country": "string",
"external_id": "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"
},
"discount_type": "percentage",
"discount_percentage": "string",
"tax_1_type": "string",
"tax_1_percentage": "string",
"tax_2_type": "string",
"tax_2_percentage": "string",
"labor_subtotal_cents": 0,
"parts_subtotal_cents": 0,
"fees_cents": 0,
"subtotal_cents": 0,
"discount_cents": 0,
"tax_1_cents": 0,
"tax_2_cents": 0,
"total_amount_cents": 0,
"labor_time_in_seconds": 0
}
]
}
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"
}