Skip to main content

​
Introduction

Most vehicles come in several different versions, each different version, or trim, come with different features. Trims make it easy to identify the exact features a vehicle has. Trim matching is a process within the Volteras platform that matches a connected vehicle with its specific trim. Volteras will aim to match a vehicle with its trim using the data fetched from the OEM, however there are cases when an exact match cannot be performed, so it will be up to the user to specify the exact trim of the vehicle. During the consent flow when an end-user connects their vehicle, they will have the ability to specify the exact trim, alternatively the trim of a vehicle can be provided by using our API. If a trim has been matched for a vehicle, the vehicle specifications endpoint will also be available. This document details how to set the trim of a vehicle via the API.

​
Supported OEMs

These OEMs support trim matching:
  • BMW
  • Hyundai
  • KIA
  • Mini
  • Tesla
  • Volvo

​
Matching a vehicle trim via the API

Request: 
curl --request GET \
  --url https://api.volteras.com/v1/vehicles/{vehicle_id}/trim/suggestions \
  --header 'Authorization: <authorization>'
Response: 
[
  {
    "id": "gdm1t-eydt0-q2mc6-1jaem-zes34",
    "name": "Tesla Model S Tri Motor AWD 1020HP"
  },
  {
    "id": "9kfnh-wcym7-w34n3-2b6jm-7tk59",
    "name": "Tesla Model S Long Range AWD 670HP"
  }
]
The next step is to use the update trim endpoint to assign a trim to a vehicle. In this example we assign the second trim to the vehicle: Request: 
curl --request PUT \
  --url https://api.volteras.com/v1/vehicles/{vehicle_id}/trim \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "9kfnh-wcym7-w34n3-2b6jm-7tk59"
}'
Response: The endpoint will return 202 status code if the request has been accepted.