curl "https://api.smartcar.com/v2.0/vehicles/{id}/engine/oil" \
-H "Authorization: Bearer {token}" \
-X "GET"
engine_oil = vehicle.engine_oil()
const engineOil = await vehicle.engineOil()
VehicleEngineOil oil = vehicle.engineOil();
engine_oil = vehicle.engine_oil
{
"lifeRemaining": 0.35
}
Vehicle Data
Oil Life
Returns the remaining life span of a vehicle’s engine oil.
curl "https://api.smartcar.com/v2.0/vehicles/{id}/engine/oil" \
-H "Authorization: Bearer {token}" \
-X "GET"
engine_oil = vehicle.engine_oil()
const engineOil = await vehicle.engineOil()
VehicleEngineOil oil = vehicle.engineOil();
engine_oil = vehicle.engine_oil
{
"lifeRemaining": 0.35
}
The Vehicles API v2.0 will be deprecated on December 1, 2026. The latest version, v3, was introduced on August 26, 2025. We recommend migrating as soon as possible to ensure continued support and access to new features.
Permission
read_engine_oil
Request
Pathstring
required
The vehicle ID of the vehicle you are making a request to.
curl "https://api.smartcar.com/v2.0/vehicles/{id}/engine/oil" \
-H "Authorization: Bearer {token}" \
-X "GET"
engine_oil = vehicle.engine_oil()
const engineOil = await vehicle.engineOil()
VehicleEngineOil oil = vehicle.engineOil();
engine_oil = vehicle.engine_oil
Response
number
The engine oil’s remaining life span based on the current quality of the oil as a percentage.
1 indicates the oil was changed recently and 0 indicates the oil should be changed immediately.
It is not a representation of how much oil is left in the vehicle.{
"lifeRemaining": 0.35
}
Was this page helpful?