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