Fuel

Fuel related endpoints. Cartrack reads fuel either from the vehicle CAN bus (if supported) or from a fitted fuel sensor. The Fuel API works only for vehicles that provide fuel data via one of these methods. If your vehicle is not reporting fuel, contact your Cartrack customer success manager to discuss available options.

📄️ Get a vehicle's fuel consumed sensor data

Get a vehicle's fuel consumed sensor data

📄️ Get fuel fills for a vehicle

This endpoint retrieves a vehicles's fuel fills for a specified period, with a maximum duration of 31 days. The API requires the tracker to be configured to read the fuel sensor data. It returns the fuel fill values in liters (with coefficient applied).

📄️ Get fuel fills for all vehicles

This endpoint retrieves fuel fills for all vehicles within your fleet, with a maximum time range of 24 hours. The API requires the vehicles to have the fuel sensor data accessible by the tracker. It returns the fuel fill values in liters (with coefficient applied).

📄️ Get fuel level history for a vehicle

This endpoint allows you to retrieve the fuel level history for a specific vehicle within a specified time frame. To use this API, your vehicle must be configured to real the fuel sensor data. The fuel level data is returned in liters with a coefficient applied. **We strongly discourage you to use this API to estimate the fuel use.**

📄️ Get fuel used estimate for a vehicle

This endpoint allows you to retrieve the fuel level for a specific vehicle, at the start and at the end of a given period. To use this API, your vehicle must be configured to read the fuel sensor data. The fuel level data is returned in liters with a coefficient applied. Our algorithm also give you the estimated fuel used over the period.

📄️ Retrieve fuel consumed sensor data for multiple vehicles

This endpoint allows you to retrieve vehicle fuel consumption for a give period. The vehicles must have the fuel consumed sensor (sensor type id 20) and Cartrack telematic device must be connected to the CAN bus. It returns the value in litres (coefficient applied). Reported events for up to 100 vehicles per request within your fleet, at the start and at the end of a given period with a maximum time range of 31 days.

📄️ Retrieve fuel used estimate for multiple vehicles

This endpoint allows you to retrieve the fuel level for up to 100 vehicles per request within your fleet, at the start and at the end of a given period with a maximum time range of 24 hours. To use this API, your vehicle must be configured to read the fuel sensor data. The fuel level data is returned in liters with a coefficient applied. Our algorithm also give you the estimated fuel used over the period.