> ## 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

> List all active fuel types available for logistics recharges

# 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`.

<Note>
  **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.
</Note>

## Request

### Headers

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication

  **Example:** `sk_live_1234567890abcdef`
</ParamField>

<ParamField header="x-organization-id" type="string" required>
  Your organization UUID

  **Example:** `a8315ef3-dd50-43f8-b7ce-d839e68d51fa`
</ParamField>

## Response

<ResponseField name="total_count" type="integer">
  Total number of active fuel types in the catalogue
</ResponseField>

<ResponseField name="fuels" type="array[object]">
  List of available fuel types

  <Expandable title="Fuel Object">
    <ResponseField name="id" type="string">
      UUID of the fuel type. Use this as `fuel_id` when creating a recharge.
    </ResponseField>

    <ResponseField name="name" type="string">
      Name of the fuel type (e.g. `diesel`, `compressed_natural_gas`)
    </ResponseField>

    <ResponseField name="unit_id" type="string">
      UUID of the measurement unit associated with this fuel (e.g. liters, kg, kWh)
    </ResponseField>

    <ResponseField name="region" type="string">
      Region for which this fuel's emission factor applies. Values: `EU`, `NA`, `GLO`
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X GET "https://api.dcycle.io/v1/logistics/fuels" \
    -H "x-api-key: ${DCYCLE_API_KEY}" \
    -H "x-organization-id: ${DCYCLE_ORG_ID}"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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']}")
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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));
  ```
</CodeGroup>

### Successful Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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"
    }
  ]
}
```

<Note>
  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.
</Note>

## 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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}
```

### 403 Forbidden

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}
```

## Related Endpoints

<CardGroup cols={2}>
  <Card title="Create Recharge" icon="gas-pump" href="/api-reference/logistics/create-recharge">
    Create a fuel consumption record using a fuel\_id from this endpoint
  </Card>

  <Card title="Create Recharges (Bulk)" icon="layer-group" href="/api-reference/logistics/create-recharges-bulk">
    Create up to 5,000 recharges in one request
  </Card>

  <Card title="Recharges Filter Options" icon="filter" href="/api-reference/logistics/recharges-unique-values">
    Get fuel IDs already used by your organization (for filters)
  </Card>

  <Card title="Get Vehicle Types (TOCs)" icon="truck" href="/api-reference/logistics/get-tocs">
    List available vehicle types for recharges
  </Card>
</CardGroup>