GET
/
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
}

​
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✅✅✅