Engine Oil Life API
Check the status of a vehicle’s engine oil life using Smartcar’s APIs.
Retrieve the remaining life span of a vehicle’s engine oil.
const smartcar = require('smartcar');
// Get all vehicles associated with this access token
const {vehicles} = await smartcar.getVehicleIds("<access-token>");
// Construct a new vehicle instance using the first vehicle's id
const vehicle = new smartcar.Vehicle(vehicles[0], "<access-token>");
// Fetch the vehicle's engine oil life
const oil = await vehicle.oil();
console.log(oil);
import smartcar
# Get all vehicles associated with this access token
response = smartcar.get_vehicle_ids("<access-token>")
# Construct a new vehicle instance using the first vehicle's id
vehicle = smartcar.Vehicle(response["vehicles"][0], "<access-token>")
# Fetch the vehicle's engine oil life
oil = vehicle.oil()
print(oil)
import com.smartcar.sdk.*;
// Get all vehicles associated with this access token
SmartcarResponse<VehicleIds> response = AuthClient.getVehicleIds("<access-token>");
String[] vehicleIds = response.getData().getVehicleIds();
// Construct a new vehicle instance using the first vehicle's id
Vehicle vehicle = new Vehicle(vehicleIds[0], "<access-token>");
// Fetch the vehicle's engine oil life
SmartcarResponse<VehicleOil> oil = vehicle.oil();
System.out.println(oil.getData().getLifeRemaining());
import (
"context"
smartcar "github.com/smartcar/go-sdk"
)
// Create a smartcar client
var smartcarClient = smartcar.NewClient()
// Get all vehicles associated with this access token
var vehicleIDs, resErr = smartcarClient.GetVehicleIDs(
context.TODO(),
&smartcar.VehicleIDsParams{Access: "<access-token>"},
);
// Construct a new vehicle instance using the first vehicle's id
var vehicle = smartcarClient.NewVehicle(&smartcar.VehicleParams{
ID: vehicleIDs.VehicleIDs[0],
AccessToken: "<access-token>"},
);
// Fetch the vehicle's engine oil life
var oil, resErr = vehicle.GetOil(context.TODO());
require 'smartcar'
# Get all vehicles associated with this access token
vehicle_ids = Smartcar::Vehicle.all_vehicle_ids(token: token)
# Construct a new vehicle instance using the first vehicle's id
vehicle = Smartcar::Vehicle.new(
token: "<access-token>",
id: vehicle_ids.first
)
# Fetch the vehicle's engine oil life
engine_oil = vehicle.engine_oil()
puts engine_oil.to_hash.slice(*%I(lifeRemaining))
// Example response from Smartcar
{
"lifeRemaining": 0.35
}
Offer automatic engine oil life checks as part of your fleet management software and predictive maintenance products.
Learn more about fleet managementInvite customers to schedule a maintenance visit when their vehicle’s engine oil reaches the end of its recommended life span.
Learn more about on-demand services