Skip to main content
GET
/
v1
/
logistics
/
fuels
List Available Fuel Types
const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/logistics/fuels', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "total_count": 123,
  "fuels": {
    "id": "<string>",
    "name": "<string>",
    "unit_id": "<string>",
    "region": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://code.dcycle.io/llms.txt

Use this file to discover all available pages before exploring further.

​
List Available Fuel Types

Retrieve the full catalogue of active fuel types that can be used when creating a logistics recharge. Use the returned id as the fuel_id field in POST /logistics/recharges.
Use this endpoint to discover fuels. Unlike GET /recharges/unique-values?field=fuel_name, this endpoint returns the complete fuel catalogue regardless of whether your organization has already created recharges — making it the right choice for new integrations.

​
Request

​
Headers

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

​
Response

​
total_count
integer
Total number of active fuel types in the catalogue
​
fuels
array[object]
List of available fuel types

​
Example

curl -X GET "https://api.dcycle.io/v1/logistics/fuels" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

​
Successful Response

{
  "total_count": 21,
  "fuels": [
    {
      "id": "a0b56b0f-216c-456e-9e0f-1876d3b57622",
      "name": "aviation_fuel",
      "unit_id": "54a709bf-79fe-4acb-ab85-5e1d7cd26eb4",
      "region": "EU"
    },
    {
      "id": "f51a1645-c201-43da-9dcd-6408be3cb517",
      "name": "diesel",
      "unit_id": "54a709bf-79fe-4acb-ab85-5e1d7cd26eb4",
      "region": "EU"
    },
    {
      "id": "65e308cf-a614-4292-88a4-275941fef66a",
      "name": "diesel",
      "unit_id": "54a709bf-79fe-4acb-ab85-5e1d7cd26eb4",
      "region": "NA"
    },
    {
      "id": "ea3adb5d-1dc1-4e93-bdb9-fe1d2964590e",
      "name": "gasoline",
      "unit_id": "54a709bf-79fe-4acb-ab85-5e1d7cd26eb4",
      "region": "EU"
    },
    {
      "id": "70caf2dd-bf76-4561-995f-6e6f6a526e44",
      "name": "compressed_natural_gas",
      "unit_id": "61743a63-ff70-459c-9567-5eee8f7dfd5c",
      "region": "EU"
    }
  ]
}
The same fuel name can appear multiple times with different region values (e.g. diesel for EU and NA). Choose the one that matches the country where your recharge takes place.

​
Fuel Catalogue

NameRegionNotes
aviation_fuelEU
b_1 … b_100GLO / EUBiodiesel blends (B1 to B100)
bio_ethanolEU
bio_liquefied_natural_gasEU
compressed_natural_gasEU
dieselEU, NA
gasolineEU
heavy_fuel_oilEU
hvoNAHydrotreated Vegetable Oil
liquefied_natural_gasEU
liquefied_petroleum_gasEU
marine_diesel_oilNA
marine_gas_oilNA

Create Recharge

Create a fuel consumption record using a fuel_id from this endpoint

Create Recharges (Bulk)

Create up to 5,000 recharges in one request

Recharges Filter Options

Get fuel IDs already used by your organization (for filters)

Get Vehicle Types (TOCs)

List available vehicle types for recharges