List Available Fuel Types

List all active fuel types available for logistics recharges

GET /v1/logistics/fuels

List Available Fuel Types

JavaScript

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

200

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

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 authentication

Example: sk_live_1234567890abcdef

x-organization-id · string · required

Your organization UUID

Example: 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

Show Fuel Object

id · string

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

name · string

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

unit_id · string

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

region · string

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

Example

cURL

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

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

Related Endpoints

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