List Vehicle Service Entries
GEThttps://secure.fleetio.com/api/v1/vehicles/:id/service_entries
List a Vehicle's Service Entries.
Request
Path Parameters
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.
Responses
- 200
- 401
- 500
OK
Response Headers
- application/json
- Schema
- Example (auto)
Schema
- Array [
- ]
Possible values: >= 1
The date and time at which this record was created.
2023-03-14T13:46:27-06:00
The date and time at which this record was most recently updated.
2023-03-14T13:46:27-06:00
The date and time at which the Service Entry was completed.
2023-03-14T13:46:27-06:00
A reference number for this Service Entry.
The date and time at which the Service Entry was started.
2023-03-14T13:46:27-06:00
*Full details on working with Custom Fields here.
Possible values: >= 1
The name of the Vehicle
that this Service Entry was performed on.
Possible values: >= 1
The name of the Vendor
that performed this service.
Possible values: >= 1
The date and time of which this Service Entry was performed.
Formatted according to ISO-8601 in User
's local time.
2023-03-14T13:46:27-06:00
service_tasks object[]required
issues object[]required
meter_entry objectnullablerequired
The total cost of labor for this record.
1.23
The total cost of labor in cents.
The total cost of parts for this record.
1.23
The total cost of parts in cents.
The pre-tax subtotal amount.
1.23
The pre-tax subtotal amount in cents.
The type of tax to apply to this record.
Possible values: [fixed
, percentage
]
percentage
The primary tax percentage amount. This field should be present when
tax_1_type
is set to percentage
.
1.23
The primary tax amount in cents.
123
The type of tax to apply to this record.
Possible values: [fixed
, percentage
]
percentage
The secondary tax percentage amount. This field should be present when tax_2_type
is
set to percentage
. Note that this secondary tax must be configured in
your Account Settings.
1.23
The secondary tax amount in cents.
The primary tax amount.
1.23
The secondary tax amount. Note that this secondary tax must be configured in your Account Settings.
1.23
The total amount.
1.23
The total amount in cents.
[
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"completed_at": "2023-03-14T13:46:27-06:00",
"reference": "string",
"started_at": "2023-03-14T13:46:27-06:00",
"custom_fields": {},
"vehicle_id": 0,
"vehicle_name": "string",
"vendor_id": 0,
"vendor_name": "string",
"work_order_id": 0,
"date": "2023-03-14T13:46:27-06:00",
"service_tasks": [
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"name": "string",
"description": "string",
"expected_duration_in_seconds": 0,
"archived_at": "2024-07-29T15:51:28.071Z",
"subtasks": [
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"name": "string",
"description": "string",
"expected_duration_in_seconds": 0,
"subtasks": [
null
],
"default_vmrs_reason_for_repair": {
"account_id": 0,
"alias": "string",
"code": "string",
"enabled": true,
"id": 0,
"name": "string",
"repair_type": "string",
"standard": true,
"standard_name": "string",
"type": "string",
"vmrs_standard_reason_for_repair": {}
},
"default_vmrs_system_group": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
},
"default_vmrs_system": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
},
"default_vmrs_assembly": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
},
"default_vmrs_component": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
}
}
],
"usage": 0,
"default_vmrs_reason_for_repair": {
"account_id": 0,
"alias": "string",
"code": "string",
"enabled": true,
"id": 0,
"name": "string",
"repair_type": "string",
"standard": true,
"standard_name": "string",
"type": "string",
"vmrs_standard_reason_for_repair": {}
},
"default_vmrs_system_group": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
},
"default_vmrs_system": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
},
"default_vmrs_assembly": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
},
"default_vmrs_component": {
"account_id": 0,
"assembly_code": "string",
"assembly_name": "string",
"code_type": "system_group",
"component_code": "string",
"component_name": "string",
"enabled": true,
"id": 0,
"permissions": {
"destroy": true
},
"standard": true,
"system_code": "string",
"system_group": "string",
"system_group_code": "string",
"system_name": "string",
"type": "string",
"vmrs_standard_system_assembly_component": {}
},
"service_task_parts": [
{
"id": 0,
"quantity": 0,
"part_id": 0,
"part_archived_at": "2024-07-29T15:51:28.071Z",
"position": 0
}
]
}
],
"issues": [
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"number": "string",
"name": "string",
"summary": "string",
"description": "string",
"state": "Open",
"reported_at": "2023-03-14T13:46:27-06:00",
"reported_by_id": 0,
"reported_by_name": "string",
"fault_id": 0,
"due_date": "2023-03-14",
"due_meter_value": "string",
"due_secondary_meter_value": 0,
"overdue": true,
"vehicle_id": 0,
"vehicle_name": "string",
"is_sample": true,
"created_by_workflow": true,
"submitted_inspection_form_id": 0,
"custom_fields": {},
"valid_required_custom_fields": true,
"dtc_alert_id": 0,
"assigned_contacts": [
{
"id": 0,
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"email": "string",
"name": "string",
"first_name": "string",
"middle_name": "string",
"last_name": "string",
"images_count": 0,
"documents_count": 0,
"comments_count": 0,
"group_id": 0,
"group_name": "string",
"group_hierarchy": "Group 1|Group 2|Group 3",
"technician": true,
"vehicle_operator": true,
"employee": true,
"birth_date": "2023-03-14",
"street_address": "123 Main St",
"street_address_line_2": "Apt 1",
"city": "string",
"region": "string",
"postal_code": "string",
"country": "string",
"employee_number": "string",
"job_title": "string",
"license_class": "string",
"license_number": "string",
"license_state": "string",
"license_expiration": "2023-03-14",
"home_phone_number": "string",
"mobile_phone_number": "string",
"work_phone_number": "string",
"other_phone_number": "string",
"start_date": "2024-07-29",
"leave_date": "2024-07-29",
"hourly_labor_rate": 0,
"custom_fields": {},
"attachment_permissions": {
"read_photos": true,
"manage_photos": true,
"read_documents": true,
"manage_documents": true
},
"default_image_url": "string",
"user": {},
"account_membership_id": 0,
"last_api_request": "2024-07-29T15:51:28.071Z",
"last_web_access": "2024-07-29T15:51:28.071Z",
"last_mobile_app_access": "2024-07-29T15:51:28.071Z"
}
],
"labels": [
{
"id": 0,
"name": "string"
}
],
"attachment_permissions": {
"read_photos": true,
"manage_photos": true,
"read_documents": true,
"manage_documents": true
},
"is_watched": false,
"vehicle_image_url": "string",
"vehicle_image_url_medium": "string",
"vehicle_image_url_small": "string",
"vehicle_image_url_large": "string",
"watchers_count": 0,
"linked_work_orders": [
{
"id": 0,
"number": 0,
"issued_at": "2024-07-29T15:51:28.071Z"
}
],
"source": {
"inspection_form": {
"id": 0,
"color": "string",
"title": "string"
},
"inspection_submissions_count": 0,
"last_inspection_submission_at": "2024-07-29T15:51:28.071Z",
"failed_inspection_item_label": "string"
},
"comments": [
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"commentable_type": "Contact",
"commentable_id": 0,
"user_id": 0,
"comment": "string",
"user_full_name": "string",
"user_image_url": "string",
"rich_content": {},
"html_content": "string",
"with_mentions": true
}
],
"comments_count": 0,
"documents": [
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"name": "string",
"description": "string",
"documentable_id": 0,
"documentable_type": "ServiceEntry",
"file_name": "string",
"file_mime_type": "string",
"file_size": 0,
"file_url": "string",
"full_file_url": "string"
}
],
"documents_count": 0,
"images": [
{
"id": 0,
"created_at": "2023-03-14T13:46:27-06:00",
"updated_at": "2023-03-14T13:46:27-06:00",
"imageable_id": 0,
"imageable_type": "ExpenseEntry",
"file_name": "string",
"file_mime_type": "image/jpeg",
"file_size": 0,
"file_url": "string",
"full_url": "string"
}
],
"images_count": 0
}
],
"meter_entry": {
"id": 0,
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"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"
},
"labor_subtotal": 1.23,
"labor_subtotal_cents": 0,
"parts_subtotal": 1.23,
"parts_subtotal_cents": 0,
"subtotal": 1.23,
"subtotal_cents": 0,
"tax_1_type": "percentage",
"tax_1_percentage": 1.23,
"tax_1_cents": 123,
"tax_2_type": "percentage",
"tax_2_percentage": 1.23,
"tax_2_cents": 0,
"tax_1": 1.23,
"tax_2": 1.23,
"total_amount": 1.23,
"total_amount_cents": 0
}
]
Request could not be authenticated
- application/json
- Schema
- Example (auto)
Schema
Possible values: >= 400
and <= 599
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.
A human-readable explanation specific to this occurrence of the problem.
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 (auto)
Schema
Possible values: >= 400
and <= 599
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.
A human-readable explanation specific to this occurrence of the problem.
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"
}
Authorization: Authorization
name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64". You can generate a new API key [here](https://secure.fleetio.com/api_keys).
name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)
- curl
- ruby
- python
- csharp
- go
- java
- nodejs
- php
- CURL