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));

import requests

url = "https://api.dcycle.io/v1/logistics/fuels"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "total_count": 123,
  "fuels": {
    "id": "<string>",
    "name": "<string>",
    "unit_id": "<string>",
    "region": "<string>"
  }
}

GET

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));

import requests

url = "https://api.dcycle.io/v1/logistics/fuels"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "total_count": 123,
  "fuels": {
    "id": "<string>",
    "name": "<string>",
    "unit_id": "<string>",
    "region": "<string>"
  }
}

← Logistics API 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

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Response

integer

Total number of active fuel types in the catalogue

array[object]

List of available fuel types

Show Fuel Object

string

UUID of the fuel type. Use this as fuel_id when creating a recharge.

string

Name of the fuel type (e.g. diesel, compressed_natural_gas)

string

UUID of the measurement unit associated with this fuel (e.g. liters, kg, kWh)

string

Region for which this fuel’s emission factor applies. Values: EU, NA, GLO

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}"

import requests
import os

api_key = os.getenv("DCYCLE_API_KEY")
org_id = os.getenv("DCYCLE_ORG_ID")

headers = {
    "x-api-key": api_key,
    "x-organization-id": org_id
}

response = requests.get(
    "https://api.dcycle.io/v1/logistics/fuels",
    headers=headers
)

result = response.json()
print(f"Available fuels: {result['total_count']}")
for fuel in result["fuels"]:
    print(f"  [{fuel['region']}] {fuel['name']} → {fuel['id']}")

const axios = require('axios');

const headers = {
  'x-api-key': process.env.DCYCLE_API_KEY,
  'x-organization-id': process.env.DCYCLE_ORG_ID
};

axios.get('https://api.dcycle.io/v1/logistics/fuels', { headers })
  .then(response => {
    const { total_count, fuels } = response.data;
    console.log(`Available fuels: ${total_count}`);
    fuels.forEach(f => console.log(`  [${f.region}] ${f.name} → ${f.id}`));
  })
  .catch(error => console.error(error));

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

Name	Region	Notes
`aviation_fuel`	EU
`b_1` … `b_100`	GLO / EU	Biodiesel blends (B1 to B100)
`bio_ethanol`	EU
`bio_liquefied_natural_gas`	EU
`compressed_natural_gas`	EU
`diesel`	EU, NA
`gasoline`	EU
`heavy_fuel_oil`	EU
`hvo`	NA	Hydrotreated Vegetable Oil
`liquefied_natural_gas`	EU
`liquefied_petroleum_gas`	EU
`marine_diesel_oil`	NA
`marine_gas_oil`	NA

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}

403 Forbidden

Cause: The authenticated user is not a member of the organization

{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}

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)

List Vehicle Types (TOCs)

List available vehicle types for recharges

​Request

​Headers

​Response

​Example

​Successful Response

​Fuel Catalogue

​Common Errors

​401 Unauthorized

​403 Forbidden

​Related Endpoints

Create Recharge

Create Recharges (Bulk)

Recharges Filter Options

List Vehicle Types (TOCs)

Request

Headers

Response

Example

Successful Response

Fuel Catalogue

Common Errors

401 Unauthorized

403 Forbidden

Related Endpoints