Create a fuel purchase transaction.

post

https://api.samsara.com/fuel-purchase

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Fuel Purchase under the Fuel & Energy category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Body Params

discount

object

The amount of money discounted from the gross purchase price of the fuel transaction in the currency of the country where the transaction occurred.

driverId

string

Samsara ID of the driver that purchased the fuel.

fuelGrade

string

enum

The grade of the fuel purchased. Valid values: Unknown, Regular, Premium

Allowed:

fuelQuantityLiters

string

required

The amount of fuel purchased in liters.

iftaFuelType

string

enum

The type of fuel purchased supported by IFTA. Valid values: Unspecified, A55, Biodiesel, CompressedNaturalGas, Diesel, E85, Electricity, Ethanol, Gasohol, Gasoline, Hydrogen, LiquifiedNaturalGas, M85, Methanol, Propane, Other

merchantName

string

Brand name of the fuel station the fuel was purchased at. For example: Shell, Bp, Exxon.

source

string

The integration provider. For example: Customer, Shell Integration

transactionLocation

string

required

The full street address for the location of the fuel transaction, as it might be recognized by Google Maps. Ideal entries should be in accordance with the format used by the national postal service of the country concerned (example: 1 De Haro St, San Francisco, CA 94107, United States). Alternatively, exact latitude/longitude can be provided (example: 40.748441, -73.985664).

transactionPrice

object

required

The price of the fuel transaction in the currency of the country where the transaction occurred.

transactionReference

string

required

length between 1 and 32

The fuel transaction reference. This is the transaction identifier. For instance, this can be the Serial Number on the invoice.

transactionTime

string

required

The time of the fuel transaction in RFC 3339 format. Timezone must be specified. For example, 2022-07-13T14:20:50.52-07:00 is a time in Pacific Daylight Time.

vehicleId

string

Samsara ID of the vehicle that purchased the fuel.

Responses

200OK response.

401Unauthorized response.

404Not Found response.

405Method Not Allowed response.

429Too Many Requests response.

500Internal Server Error response.

501Not Implemented response.

502Bad Gateway response.

503Service Unavailable response.

504Gateway Timeout response.

defaultBad Request response.