Create a fuel entry

curl --request POST \
  --url https://app.unitedlogistics.com.do/api/v1/fuel/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "vehicle_number": "L18N / L534991",
  "product_name": "Diesel Regular",
  "product_type": "Regular",
  "gallons": 60.008,
  "price_per_gallon": 224.8
}
'

{
  "data": {
    "id": "589c258d-4736-4b6f-876f-87835992191e",
    "org_id": "d87f7281-ea19-45cd-b6fd-d8eb9e310da1",
    "transaction_date": "2026-02-26T03:15:47.000Z",
    "transaction_id": "TXN-9921",
    "notes": null,
    "vehicle_external_id": 16056,
    "vehicle_number": "L18N / L534991",
    "vehicle_name": "L18N",
    "driver_external_id": null,
    "driver_key": null,
    "name": "Juan Pérez",
    "product_id": "f788c39d-02c8-4bd6-aa1a-fa2af011b5a3",
    "product_name": "Diesel Regular",
    "product_type": "Regular",
    "vendor_id": "2f81f423-db0c-46d8-923e-c177fa78a54c",
    "vendor_name": "Estación El Higuero - United Petroleum",
    "vendor_address": "Santo Domingo Norte, DO",
    "gallons": 60.008,
    "price_per_gallon": 224.8,
    "total_cost": 13489.8,
    "odometer_reading": 10997,
    "previous_odometer_reading": 10120,
    "distance_traveled": 877,
    "fuel_efficiency": 14.61,
    "trip_external_id": null,
    "matched_message_id": 6213486243,
    "gps_odometer_reading": 10997.05,
    "karma_driver_id": null,
    "source": "API",
    "reference_id": "300030586",
    "created_by": null,
    "created_at": "2026-02-26T15:30:03.048Z",
    "updated_at": "2026-02-26T15:30:03.048Z"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Invalid fuel entry payload.",
    "details": {
      "fieldErrors": {
        "gallons": [
          "gallons must be greater than 0"
        ]
      }
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "API key missing or invalid."
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "API key is missing required scope: fuel_entries:write."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "El vehículo especificado no existe en esta organización."
  }
}

{
  "error": {
    "code": "too_many_requests",
    "message": "Rate limit exceeded."
  }
}

POST

fuel

entries

curl --request POST \
  --url https://app.unitedlogistics.com.do/api/v1/fuel/entries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "vehicle_number": "L18N / L534991",
  "product_name": "Diesel Regular",
  "product_type": "Regular",
  "gallons": 60.008,
  "price_per_gallon": 224.8
}
'

{
  "data": {
    "id": "589c258d-4736-4b6f-876f-87835992191e",
    "org_id": "d87f7281-ea19-45cd-b6fd-d8eb9e310da1",
    "transaction_date": "2026-02-26T03:15:47.000Z",
    "transaction_id": "TXN-9921",
    "notes": null,
    "vehicle_external_id": 16056,
    "vehicle_number": "L18N / L534991",
    "vehicle_name": "L18N",
    "driver_external_id": null,
    "driver_key": null,
    "name": "Juan Pérez",
    "product_id": "f788c39d-02c8-4bd6-aa1a-fa2af011b5a3",
    "product_name": "Diesel Regular",
    "product_type": "Regular",
    "vendor_id": "2f81f423-db0c-46d8-923e-c177fa78a54c",
    "vendor_name": "Estación El Higuero - United Petroleum",
    "vendor_address": "Santo Domingo Norte, DO",
    "gallons": 60.008,
    "price_per_gallon": 224.8,
    "total_cost": 13489.8,
    "odometer_reading": 10997,
    "previous_odometer_reading": 10120,
    "distance_traveled": 877,
    "fuel_efficiency": 14.61,
    "trip_external_id": null,
    "matched_message_id": 6213486243,
    "gps_odometer_reading": 10997.05,
    "karma_driver_id": null,
    "source": "API",
    "reference_id": "300030586",
    "created_by": null,
    "created_at": "2026-02-26T15:30:03.048Z",
    "updated_at": "2026-02-26T15:30:03.048Z"
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Invalid fuel entry payload.",
    "details": {
      "fieldErrors": {
        "gallons": [
          "gallons must be greater than 0"
        ]
      }
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "API key missing or invalid."
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "API key is missing required scope: fuel_entries:write."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "El vehículo especificado no existe en esta organización."
  }
}

{
  "error": {
    "code": "too_many_requests",
    "message": "Rate limit exceeded."
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer ulk__. Cree la clave en Configuración → API.

Body

application/json

vehicle_number

string

required

Denormalized vehicle number/plate at the time of the refuel.

Required string length: 1 - 255

Example:

"L18N / L534991"

product_name

string

required

Required string length: 1 - 255

Example:

"Diesel Regular"

product_type

string

required

Required string length: 1 - 255

Example:

"Regular"

gallons

number

required

Example:

60.008

vehicle_external_id

integer | null

Provider vehicle id (legacy vehicle_id). Enables trip/GPS matching.

Example:

16056

vehicle_name

string | null

Maximum string length: 255

driver_external_id

integer | null

driver_key

string | null

Maximum string length: 255

name

string | null

Driver name (denormalized). Defaults to Desconocido.

Maximum string length: 255

Example:

"Juan Pérez"

product_id

string<uuid> | null

vendor_id

string<uuid> | null

vendor_name

string | null

Maximum string length: 255

vendor_address

string | null

Maximum string length: 500

total_cost

number

Transaction total; price_per_gallon is inferred when provided.

Required range: x >= 0

Example:

13489.8

price_per_gallon

number

Required range: x >= 0

Example:

224.8

odometer_reading

number

Required range: x >= 0

Example:

10997

transaction_date

string<date-time> | null

Example:

"2026-02-26T03:15:47.000Z"

transaction_id

string | null

Maximum string length: 255

notes

string | null

Maximum string length: 2000

source

enum<string> | null

Origin of the entry. manual for UI capture, import for bulk CSV/Excel, API for integrations. Legacy ERM is accepted and stored as manual.

Available options:

API,

manual,

import

Example:

"API"

reference_id

string | null

Maximum string length: 255

trip_external_id

integer | null

matched_message_id

integer | null

gps_odometer_reading

number | null

Required range: x >= 0

karma_driver_id

integer | null

Response

Created

data

object

required

Show child attributes

Guía

Referencia

Authorizations

Body

Response