FleetbaseFleetbase

Fuel Transactions

Fuel transactions represent imported or recorded fuel-card/provider transactions exposed to API users as fuel transactions.

The Fuel Transaction object

A fuel transaction stores provider transaction identity, matched vehicle/order/fuel report links, station data, volume, amount, odometer, and sync status.
Attributes
idstringoptional

Public fuel transaction identifier.

providerstringoptional

Fuel provider key.

provider_transaction_idstringoptional

Provider transaction identifier.

vehiclestringoptional

Matched vehicle public ID, when loaded.

driverstringoptional

Matched driver public ID, when loaded.

orderstringoptional

Matched order public ID, when loaded.

fuel_reportstringoptional

Generated fuel report public ID, when loaded.

station_namestringoptional

Fuel station name.

volumenumberoptional

Fuel volume.

sync_statusstringoptional

Sync or review status.

The Fuel Transaction object
{
  "id": "fuel_provider_transaction_3KpL7Vz9Qx",
  "provider": "petroapp",
  "provider_transaction_id": "TX-10001",
  "vehicle": "vehicle_7YqM3KpL2n",
  "station_name": "North Depot Fuel",
  "volume": 42.5,
  "metric_unit": "liter",
  "amount": 6500,
  "currency": "USD",
  "sync_status": "matched",
  "updated_at": "2026-05-07T08:30:00.000000Z",
  "created_at": "2026-05-07T08:30:00.000000Z"
}
POST/v1/fuel-transactions

Create a Fuel Transaction

Create a fuel transaction.

Body parameters
providerstringoptional

Fuel provider key.

provider_transaction_idstringoptional

Provider transaction identifier.

connectionstringoptional

Fuel provider connection public ID.

vehiclestringoptional

Vehicle public ID.

driverstringoptional

Driver public ID.

orderstringoptional

Order public ID.

fuel_reportstringoptional

Fuel report public ID.

transaction_attimestampoptional

Transaction timestamp.

volumenumberoptional

Fuel volume.

amountcurrencyoptional

Transaction amount.

POST/v1/fuel-transactions
curl -X POST https://api.fleetbase.io/v1/fuel-transactions \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "provider": "petroapp",
  "provider_transaction_id": "TX-10001",
  "vehicle": "{{vehicle_id}}",
  "station_name": "North Depot Fuel",
  "transaction_at": "2026-05-07T08:30:00Z",
  "volume": 42.5,
  "metric_unit": "liter",
  "amount": 6500,
  "currency": "USD"
}'
201 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
GET/v1/fuel-transactions

Query Fuel Transactions

Query fuel transactions.

Query parameters
querystringoptional

Search query for fuel transactions.

limitintegeroptional

Maximum number of records to return.

pageintegeroptional

Page number for paginated results.

sortstringoptional

Sort expression, such as -created_at.

providerstringoptional

Filter by provider.

sync_statusstringoptional

Filter by sync status.

vehiclestringoptional

Filter by vehicle public ID.

connectionstringoptional

Filter by connection public ID.

transaction_attimestampoptional

Filter by transaction date or range.

GET/v1/fuel-transactions
curl https://api.fleetbase.io/v1/fuel-transactions \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
GET/v1/fuel-transactions

Retrieve a Fuel Transaction

Retrieve a fuel transaction.

GET/v1/fuel-transactions
curl https://api.fleetbase.io/v1/fuel-transactions \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
PUT/v1/fuel-transactions

Update a Fuel Transaction

Update a fuel transaction.

Body parameters
providerstringoptional

Fuel provider key.

provider_transaction_idstringoptional

Provider transaction identifier.

connectionstringoptional

Fuel provider connection public ID.

vehiclestringoptional

Vehicle public ID.

driverstringoptional

Driver public ID.

orderstringoptional

Order public ID.

fuel_reportstringoptional

Fuel report public ID.

transaction_attimestampoptional

Transaction timestamp.

volumenumberoptional

Fuel volume.

amountcurrencyoptional

Transaction amount.

PUT/v1/fuel-transactions
curl -X PUT https://api.fleetbase.io/v1/fuel-transactions \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "sync_status": "reviewed"
}'
200 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
DELETE/v1/fuel-transactions

Delete a Fuel Transaction

Delete a fuel transaction.

DELETE/v1/fuel-transactions
curl -X DELETE https://api.fleetbase.io/v1/fuel-transactions \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "deleted": true
}
POST/v1/fuel-transactions/match-vehicle

Match Fuel Transaction Vehicle

Match this fuel transaction to a vehicle.

Body parameters
vehiclestringoptional

Vehicle public ID.

POST/v1/fuel-transactions/match-vehicle
curl -X POST https://api.fleetbase.io/v1/fuel-transactions/match-vehicle \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "vehicle": "{{vehicle_id}}"
}'
200 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
POST/v1/fuel-transactions/match-order

Match Fuel Transaction Order

Match this fuel transaction to an order.

Body parameters
orderstringoptional

Order public ID.

POST/v1/fuel-transactions/match-order
curl -X POST https://api.fleetbase.io/v1/fuel-transactions/match-order \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "order": "{{order_id}}"
}'
200 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
POST/v1/fuel-transactions/reprocess

Reprocess Fuel Transaction

Reprocess matching and fuel report generation for this fuel transaction.

POST/v1/fuel-transactions/reprocess
curl -X POST https://api.fleetbase.io/v1/fuel-transactions/reprocess \
  -H "Authorization: Bearer flb_live_…"
200 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
POST/v1/fuel-transactions/review

Review Fuel Transaction

Mark this fuel transaction as reviewed or ignored.

POST/v1/fuel-transactions/review
curl -X POST https://api.fleetbase.io/v1/fuel-transactions/review \
  -H "Authorization: Bearer flb_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "reviewed"
}'
200 OK
{
  "id": "<string>",
  "object": "fuel_transactions"
}
Fuel Transactions | Fleetbase