---
title: "Create a new fuel purchase transaction"
method: POST
path: "/v1/fuel_purchases"
---

# Create a new fuel purchase transaction

`POST /v1/fuel_purchases`

## Request

- Base URL: `https://api.gomotive.com`
- URL: `https://api.gomotive.com/v1/fuel_purchases`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/gomotive/apis/motive/docs/v1/fuel_purchases/post.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `source` string

## Request body

- object
  - `vehicle_id` integer, required: Specify the ID of the vehicle for which you want to create a new fuel purchase.
  - `driver_id` integer, required: Specify the ID of the driver.
  - `purchased_at` string, date, required: Specify the time at which the fuel was purchased.
  - `jurisdiction` string, required: Specify the jurisdiction from where the fuel was purchased at.
  - `fuel_type` string, required: Specify the type of the fuel that was purchased. Allowed values are: ['diesel', 'gasoline', 'propane', 'lng', 'cng', 'ethanol', 'methanol', 'e85', 'm85', 'a55', 'biodiesel', 'other']
  - `total_cost` string: Specify the total cost of the fuel purchase.
  - `currency` string: Specify the currency in which the fuel was purchased. Allowed values are USD or CAD.
  - `fuel` string, required: Specify the total amount of the fuel purchased.
  - `fuel_unit` string, required: Specify the units of the fuel. Allowed values are gal for Gallons, or ltr for Litres.
  - `ref_no` string: Specify the reference number of the fuel purchase.
  - `vendor` string: Enter the name of the fuel vendor.
  - `odometer` integer: Mention the Odometer reading at the time of the fuel purchase.
  - `odometer_unit` string: Specify the units of the odometer at the time of the fuel purchase. Allowed values are: KM for Kilometres, or MI for Miles.
  - `receipt` string[]: Specify the URL of the location where the receipt is uploaded.
  - `location` string: Specify the location of the fuel purchase.

## Response `200`

200

- object
  - `fuel_purchase` object
    - `id` integer
    - `offline_id` string
    - `purchased_at` string
    - `jurisdiction` string
    - `fuel_type` string
    - `ref_no` unknown
    - `vendor` unknown
    - `total_cost` integer
    - `currency` string
    - `fuel` integer
    - `fuel_unit` string
    - `odometer` unknown
    - `odometer_unit` string
    - `receipt_upload_url` unknown
    - `receipt_filename` unknown
    - `location` string
    - `uploader` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `email` string
      - `role` string
      - `deactivated_at` unknown
    - `vehicle` object
      - `id` integer
      - `number` string
      - `year` string
      - `make` string
      - `model` string
      - `vin` string
      - `metric_units` boolean
    - `driver` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `username` string
      - `email` string
      - `driver_company_id` unknown
      - `status` string
      - `role` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/gomotive/apis/motive.md) - [All operations](https://skmtc.dev/gomotive/apis/motive/llms.txt) - [OpenAPI document](https://skmtc.dev/gomotive/apis/motive/revisions/c71780e497f5?raw)