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