Skip to main content
GET
/
v2.0
/
vehicles
/
{id}
/
fuel
curl "https://api.smartcar.com/v2.0/vehicles/{id}/fuel" \
    -H "Authorization: Bearer {token}" \
    -X "GET"

{
  "amountRemaining": 53.2,
  "percentRemaining": 0.3,
  "range": 40.5
}
The Vehicles API v2.0 will be deprecated by Q3 of 2026. We recommend migrating to the latest version as soon as possible to ensure continued support and access to new features.

​
Permission

read_fuel
This endpoint may return null values for vehicles sold in Europe. Please see the Notes section for details.

​
Request

Path
​
id
string
required
The vehicle ID of the vehicle you are making a request to.
curl "https://api.smartcar.com/v2.0/vehicles/{id}/fuel" \
    -H "Authorization: Bearer {token}" \
    -X "GET"

​
Response

​
percentRemaining
number | null
The remaining level of fuel in the tank as a percentage.
​
amountRemaining
number | null
default:"liters"
The amount of fuel in the tank.
​
range
number | null
default:"kilometers"
The estimated remaining distance the car can travel.
{
  "amountRemaining": 53.2,
  "percentRemaining": 0.3,
  "range": 40.5
}

​
Notes

The table below indicates values Smartcar attempts to retrieve from vehicles sold in Europe.
rangepercentRemainingamountRemaining
Audi✅✅
BMW, MINI✅✅✅
Citroen, DS, Opel, Peugeot, Vauxhall✅✅
Ford✅✅
Hyundai✅✅
Jaguar, Land Rover✅✅
Kia✅✅
Mazda✅✅
Mercedes✅✅
Renault✅✅
Skoda, Volkswagen✅✅
Volvo✅✅✅