Fuel Reports

Fuel reports record vehicle refueling events and fuel costs. Use them to track fuel purchases, odometer context, and operational expenses for fleet vehicles.

The Fuel Report object

A fuel report records a driver's fuel purchase or fuel usage report with odometer, amount, volume, unit, location, vehicle, and status data.

Attributes

idstringoptional

Public fuel report identifier.

reporterobjectoptional

User who reported the fuel purchase, when loaded.

vehicleobjectoptional

Vehicle associated with the fuel report, when loaded.

driverobjectoptional

Driver associated with the fuel report, when loaded.

odometernumberoptional

Odometer reading at the time of the report.

amountcurrencyoptional

Monetary amount for the fuel purchase.

currencycurrencyoptional

Three-letter currency code.

volumenumberoptional

Fuel volume.

metric_unitstringoptional

Unit for the fuel volume.

typestringoptional

Fuel report type.

statusstringoptional

Fuel report status.

locationobjectoptional

Location where fuel was reported.

updated_attimestampoptional

Timestamp when the fuel report was last updated.

created_attimestampoptional

Timestamp when the fuel report was created.

The Fuel Report object

{
  "id": "fuel_report_4Mnp8Qx2Vz",
  "vehicle": null,
  "driver": null,
  "odometer": 10042,
  "amount": 6500,
  "currency": "USD",
  "volume": 42.5,
  "metric_unit": "liters",
  "type": null,
  "status": "created",
  "location": {
    "latitude": 1.3521,
    "longitude": 103.8198
  },
  "updated_at": "2026-05-07T08:30:00.000000Z",
  "created_at": "2026-05-07T08:30:00.000000Z"
}

POST/v1/fuel-reports

Create a Fuel Report

Body parameters

driverstringrequired

Driver ID reporting the fuel purchase.

odometernumberrequired

Vehicle odometer reading at the time of the report.

volumenumberrequired

Fuel volume purchased or reported.

metric_unitstringoptional

Unit used for the fuel volume.

locationobjectoptional

Location where the fuel was purchased or reported.

amountcurrencyoptional

Monetary amount for the fuel purchase.

POST/v1/fuel-reports

curl -X POST https://api.fleetbase.io/v1/fuel-reports \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "driver": "{{driver_id}}",
  "odometer": 12042,
  "volume": 42.5,
  "metric_unit": "liter",
  "location": {
    "latitude": 1.3521,
    "longitude": 103.8198
  },
  "amount": 120.5,
  "currency": "USD",
  "status": "submitted"
}'

GET/v1/fuel-reports

Query Fuel Reports

Query parameters

limitintegeroptional

Maximum number of fuel reports to return.

offsetintegeroptional

Number of fuel reports to skip before returning results.

sortstringoptional

Sort expression for the fuel report query.

driverstringoptional

Filters fuel reports by driver ID.

vehiclestringoptional

Filters fuel reports by vehicle ID.

GET/v1/fuel-reports

curl https://api.fleetbase.io/v1/fuel-reports?limit=25&offset=0&sort=created_at \
  -H "Authorization: Bearer flb_live_…"

GET/v1/fuel-reports/:id

Retrieve a Fuel Report

GET/v1/fuel-reports/:id

curl https://api.fleetbase.io/v1/fuel-reports/:id \
  -H "Authorization: Bearer flb_live_…"

PUT/v1/fuel-reports/:id

Update a Fuel Report

Body parameters

driverstringoptional

Driver ID reporting the fuel purchase.

odometernumberoptional

Vehicle odometer reading at the time of the report.

volumenumberoptional

Fuel volume purchased or reported.

metric_unitstringoptional

Unit used for the fuel volume.

locationobjectoptional

Location where the fuel was purchased or reported.

amountcurrencyoptional

Monetary amount for the fuel purchase.

PUT/v1/fuel-reports/:id

curl -X PUT https://api.fleetbase.io/v1/fuel-reports/:id \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "odometer": 12050,
  "volume": 43.1,
  "metric_unit": "liter",
  "amount": 122.75,
  "currency": "USD",
  "status": "approved"
}'

DELETE/v1/fuel-reports/:id

Delete a Fuel Report

DELETE/v1/fuel-reports/:id

curl -X DELETE https://api.fleetbase.io/v1/fuel-reports/:id \
  -H "Authorization: Bearer flb_live_…"