Skip to main content
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