List Vehicle Service Entries
List a Vehicle's Service Entries.
Path Parameters
- id string required
The Fleetio ID of the relevant Vehicle.
You may also look up Vehicles by their VIN, license plate, or other external ID. See the guide on External Vehicle Ids for information on how to set this up.
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.
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.
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.
{
"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-18",
"updated_at": "2024-11-18",
"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-18",
"updated_at": "2024-11-18",
"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
},
"labels": [
{
"id": 0,
"name": "string"
}
],
"vendor": {
"name": "string",
"phone": "string",
"city": "string",
"region": "string",
"postal_code": "string",
"country": "string",
"external_id": "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
}
]
}
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"
}