Skip to main content
POST
Consumptions CSV Import
← Vehicles API Generate a presigned S3 upload URL for bulk importing vehicle consumption records via CSV file. After uploading the CSV to the returned URL, the system processes the file asynchronously and creates the consumption records.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body Parameters

string
required
Name of the CSV file to upload (must end in .csv)Example: fleet-fuel-q1-2025.csv

Response

string
Presigned S3 URL to upload the CSV file via PUT request
string
The file name as stored
string
UUID of the created file record for tracking
string
S3 key where the file will be stored
string
Confirmation message

Example

Successful Response

Row validation: unit per fuel

Each row’s unit_measure must be one of the units its consumption’s fuel accepts (the fuel_units of List Vehicle Fuels). The consumption’s fuel is the row’s fuel(optional) value, or the vehicle’s primary fuel when that cell is blank, so on a multi-fuel vehicle the same unit can be valid on one row and refused on another. A refused row is stored in error with ERR_UNIT_NOT_ALLOWED_FOR_FUEL and is not calculated.

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

422 Unprocessable Entity

Cause: Invalid or missing file name in the request body

List Consumptions

Browse imported consumption records

Delete by File

Delete all consumptions from a specific import