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

Query Parameters

string

Country ISO 3166-1 alpha-2 code. Returns one fuel per type: the variant a recharge in that country uses, the one a file import or fuel in POST /logistics/recharges picks (the country’s region, else global, else EU, else any region). Without it, every variant, as before. A country without a region (such as AQ or BV) has no fuel factor: the list is empty.Example: US

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

422 Validation Error

Cause: country is not an ISO 3166-1 alpha-2 code.

{
  "detail": [
    {
      "loc": ["query", "country"],
      "msg": "Not Valid Country Code, must be ISO 3166-1 alpha-2",
      "type": "value_error"
    }
  ]
}

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

​Query Parameters

​Response

​Example

​Successful Response

​Fuel Catalogue

​Common Errors

​401 Unauthorized

​403 Forbidden

​422 Validation Error

​Related Endpoints

Create Recharge

Create Recharges (Bulk)

Recharges Filter Options

List Vehicle Types (TOCs)

Request

Headers

Query Parameters

Response

Example

Successful Response

Fuel Catalogue

Common Errors

401 Unauthorized

403 Forbidden

422 Validation Error

Related Endpoints