Fuel Types Lookup

<span class="api-method api-method-get">GET</span> /v1/fuel/types

Returns all supported fuel types with their available units, categories, and default units.

Request

This endpoint has no required parameters. It returns all 16 fuel types.

Optional Parameters

Parameter	Type	Description
`category`	string	Filter by category: `gaseous`, `liquid`, `solid`, `biofuel`

Example Request

All fuel types

curl "https://api.emissions.dev/v1/fuel/types" \
  -H "Authorization: Bearer em_live_xxxxxxxxxxxx"

Filter by category

curl "https://api.emissions.dev/v1/fuel/types?category=biofuel" \
  -H "Authorization: Bearer em_live_xxxxxxxxxxxx"

Example Response

{
  "data": [
    {
      "fuel_type": "natural_gas",
      "label": "Natural Gas",
      "category": "gaseous",
      "is_biofuel": false,
      "available_units": ["kwh", "therm", "m3"],
      "default_unit": "kwh"
    },
    {
      "fuel_type": "lpg",
      "label": "LPG (Liquefied Petroleum Gas)",
      "category": "gaseous",
      "is_biofuel": false,
      "available_units": ["kwh", "litre", "kg"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "cng",
      "label": "CNG (Compressed Natural Gas)",
      "category": "gaseous",
      "is_biofuel": false,
      "available_units": ["kwh", "kg"],
      "default_unit": "kg"
    },
    {
      "fuel_type": "biogas",
      "label": "Biogas / Biomethane",
      "category": "biofuel",
      "is_biofuel": true,
      "available_units": ["kwh"],
      "default_unit": "kwh"
    },
    {
      "fuel_type": "diesel",
      "label": "Diesel (Gas Oil)",
      "category": "liquid",
      "is_biofuel": false,
      "available_units": ["kwh", "litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "petrol",
      "label": "Petrol (Gasoline)",
      "category": "liquid",
      "is_biofuel": false,
      "available_units": ["kwh", "litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "kerosene",
      "label": "Burning Oil / Kerosene",
      "category": "liquid",
      "is_biofuel": false,
      "available_units": ["kwh", "litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "fuel_oil",
      "label": "Fuel Oil (Heavy)",
      "category": "liquid",
      "is_biofuel": false,
      "available_units": ["kwh", "litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "red_diesel",
      "label": "Gas Oil (Red Diesel / Off-road)",
      "category": "liquid",
      "is_biofuel": false,
      "available_units": ["kwh", "litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "biodiesel",
      "label": "Biodiesel (B100 / FAME)",
      "category": "biofuel",
      "is_biofuel": true,
      "available_units": ["litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "hvo",
      "label": "HVO (Hydrotreated Vegetable Oil)",
      "category": "biofuel",
      "is_biofuel": true,
      "available_units": ["litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "bioethanol",
      "label": "Bioethanol",
      "category": "biofuel",
      "is_biofuel": true,
      "available_units": ["litre"],
      "default_unit": "litre"
    },
    {
      "fuel_type": "wood_logs",
      "label": "Wood Logs",
      "category": "biofuel",
      "is_biofuel": true,
      "available_units": ["kwh", "kg"],
      "default_unit": "kg"
    },
    {
      "fuel_type": "wood_pellets",
      "label": "Wood Pellets",
      "category": "biofuel",
      "is_biofuel": true,
      "available_units": ["kwh", "kg"],
      "default_unit": "kg"
    },
    {
      "fuel_type": "coal_industrial",
      "label": "Coal (Industrial)",
      "category": "solid",
      "is_biofuel": false,
      "available_units": ["kwh", "kg"],
      "default_unit": "kg"
    },
    {
      "fuel_type": "coal_domestic",
      "label": "Coal (Domestic / Household)",
      "category": "solid",
      "is_biofuel": false,
      "available_units": ["kwh", "kg"],
      "default_unit": "kg"
    }
  ],
  "meta": {
    "total_fuel_types": 16,
    "categories": ["gaseous", "liquid", "solid", "biofuel"],
    "source": "DEFRA 2025 - GHG Conversion Factors"
  }
}

Response Fields

Field	Type	Description
`fuel_type`	string	Identifier to use in `/v1/fuel/emissions` requests
`label`	string	Human-readable fuel name
`category`	string	`gaseous`, `liquid`, `solid`, or `biofuel`
`is_biofuel`	boolean	`true` if biogenic carbon rules apply
`available_units`	array	Units this fuel accepts
`default_unit`	string	Unit used when `unit` parameter is omitted

Category	Fuels	Typical Use
`gaseous`	natural_gas, lpg, cng, biogas	Heating, cooking, industrial processes
`liquid`	diesel, petrol, kerosene, fuel_oil, red_diesel	Generators, boilers, off-road vehicles
`biofuel`	biodiesel, hvo, bioethanol, wood_logs, wood_pellets	Renewable alternatives, biomass heating
`solid`	coal_industrial, coal_domestic	Industrial processes, legacy heating

Use Cases

Build a fuel selector

Use this endpoint to populate a dropdown of fuel types in your application, grouped by category. The label field provides user-friendly names.

Validate user input

Before calling /v1/fuel/emissions, check available_units to ensure the user's unit is valid for their selected fuel type.

Biofuel comparison tools

Filter by category=biofuel to build comparison tools showing the emissions reduction from switching to renewable fuels.