Skip to main content
POST
/
v2
/
telematics
/
fuel-transactions
Create Fuel Transaction
curl --request POST \
  --url https://api.catenatelematics.com/v2/telematics/fuel-transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "fuel_volume": 123,
  "fuel_volume_unit": "CUBIC_METER"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Documentation Index

Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt

Use this file to discover all available pages before exploring further.

Provisional endpoint
This endpoint is available for early access. The core schema is stable, but minor details — such as field names or added fields — may change before it becomes generally available. Backward compatibility is not guaranteed.

See API Stability & Versioning for details on provisional endpoints.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Fuel transaction model for creating new records

​
connection_id
string<uuid>
required

Unique identifier of the connection at Catena Telematics which will be used to create this resource. A connection represents a Fleet/TSP pairing.

​
fuel_volume
number
required

Volume of fuel purchased

​
fuel_volume_unit
enum<string>
required

Unit for fuel_volume

Available options:
CUBIC_METER,
LITER,
US_GALLON,
IMPERIAL_GALLON
​
fleet_ref
string | null

External fleet reference in the partner system.

​
source_driver_id
string | null

External system identifier for the driver (from the source system)

​
source_vehicle_id
string | null

External system identifier for the vehicle (from the source system)

​
source_co_driver_id
string | null

External system identifier for the co-driver (from the source system)

​
location
Point · object

Geographic location where the fuel transaction occurred (latitude/longitude)

​
location_string
string | null

Human-readable location where the fuel transaction occurred

​
odometer
number | null

Vehicle odometer reading at the time of the transaction

​
odometer_unit
enum<string> | null

Unit for odometer

Available options:
miles,
meters,
kilo_meters
​
transaction_time
string<date-time> | null

Timestamp of the transaction as reported by the source system (must be UTC)

​
transaction_jurisdiction
string | null

Jurisdiction where the transaction occurred (e.g., state or province code)

​
fuel_type
enum<string> | null

Type of fuel purchased

Available options:
GASOLINE,
GASOLINE,
GASOLINE,
DIESEL,
DIESEL,
DIESEL,
ETHANOL,
ETHANOL,
ETHANOL,
METHANOL,
METHANOL,
PROPANE,
LPG,
CNG,
LNG,
HYDROGEN,
ELECTRICITY,
HYBRID
​
fuel_vendor
string | null

Name of the fuel vendor or station

​
total_cost

Total cost of the transaction

​
currency
string | null

Currency of the total cost

Response

The request to create the fuel transaction has been accepted and is being processed.

Resource operation model for API responses

​
id
string<uuid>
required

Unique identifier for the resource operation.