Service History

Retrieve service records tracked by the vehicle’s dealer or manually added by the vehicle owner. Currently supporting Ford, Lincoln, Toyota, Lexus, Mazda and Volkswagen (US)

cURL

curl "https://api.smartcar.com/v2.0/vehicles/{id}/service/history" \
-H "Authorization: Bearer {token}" \
-X "GET"

Example Response

{
      "serviceId": null,
      "odometerDistance": 46047.22,
      "serviceDate": "2023-06-28T22:21:41.583Z",
      "serviceTasks": [
            {
            "taskId": "3262",
            "taskDescription": "Service Task 0"
            },
            {
            "taskId": "3041",
            "taskDescription": null
            },
            {
            "taskId": null,
            "taskDescription": null
            }
      ],
      "serviceDetails": [
            {
            "type": "Service Details Type 0",
            "value": "Service Details Value 0"
            },
            {
            "type": "Service Details Type 1",
            "value": null
            }
      ],
      "serviceCost": {
            "totalCost": null,
            "currency": null
      }
}

The Vehicles API v2.0 will be deprecated by Q4 of 2026. We recommend migrating to the latest version as soon as possible to ensure continued support and access to new features.

Permission

read_service_history

cURL

curl "https://api.smartcar.com/v2.0/vehicles/{id}/service/history" \
-H "Authorization: Bearer {token}" \
-X "GET"

Request

Path

id · string · required

The vehicle ID of the vehicle you are making a request to.

Response

serviceID · string | null

A unique identifier of the service record.

serviceDate · timestamp | null

The date and time the vehicle was serviced

odometerDistance · string | null

The odometer of the vehicle at time of service in kilometers.

Show serviceTasks

taskID · string | null

The unique identifier of the tasks completed as part of the service event.

taskDescription · string | null

Tasks completed as part of the service event. Note that not all makes provide service tasks.

Additional service details.

Show service details

type · string | null

Indicates if the service event was completed by a dealership or manually entered by the vehicle owner.

An overview of service costs.

Show service cost

totalCost · string | null

The total cost of the service event. Note that not all makes provide service cost.

currency · string | null

Identifies the currency used for service cost.

Example Response

{
      "serviceId": null,
      "odometerDistance": 46047.22,
      "serviceDate": "2023-06-28T22:21:41.583Z",
      "serviceTasks": [
            {
            "taskId": "3262",
            "taskDescription": "Service Task 0"
            },
            {
            "taskId": "3041",
            "taskDescription": null
            },
            {
            "taskId": null,
            "taskDescription": null
            }
      ],
      "serviceDetails": [
            {
            "type": "Service Details Type 0",
            "value": "Service Details Value 0"
            },
            {
            "type": "Service Details Type 1",
            "value": null
            }
      ],
      "serviceCost": {
            "totalCost": null,
            "currency": null
      }
}