Fuel Combustion
Emissions API
Convert litres, kWh, or kg of fuel into CO2e. 16 fuel types across gas, liquid, solid, and biofuels — all from DEFRA 2025. No sales calls required.
View transparent pricing · 500 free requests/month
"co2e": 3106.1,
"co2e_unit": "kg",
"scope_1": 2747.4,
"scope_3_wtt": 358.5,
"fuel_label": "Natural Gas"
}
16 fuel types. Four categories.
From natural gas heating to backup diesel generators — every fuel your Scope 1 reporting needs.
Gaseous Fuels
Natural gas, LPG, CNG, biogas. Accept kWh, therms, m³, litres, or kg depending on the fuel.
natural_gas
lpg
cng
biogas
Liquid Fuels
Diesel, petrol, kerosene, fuel oil, red diesel. Accept litres or kWh. Covers generators, boilers, and fleet fuel.
diesel
petrol
kerosene
fuel_oil
red_diesel
Biofuels
Biodiesel, HVO, bioethanol, wood logs, wood pellets. Direct CO₂ reported as zero (biogenic carbon) — only CH₄ and N₂O counted.
biodiesel
hvo
bioethanol
wood_logs
wood_pellets
Solid Fuels
Industrial and domestic coal. Accept kWh or kg. Includes high-carbon warning with lower-carbon alternatives.
coal_industrial
coal_domestic
Real-world use cases
See how sustainability platforms, facility managers, and energy auditors integrate fuel emissions data.
Corporate Scope 1 Reporting
Convert gas bills, diesel receipts, and fuel logs into Scope 1 CO2e. Calculate direct emissions for every site in one batch.
- Gas, diesel, petrol, kerosene — all in one API
- Individual CO₂, CH₄, and N₂O gas breakdown
- Multiple input units per fuel type
- Full audit trail with DEFRA 2025 references
Scope 1 reporting is mandatory under SECR, CSRD, SB 253, and SEC climate rules.
// Calculate Scope 1 for all company fuel use
const fuelConsumption = [
{ label: "Office heating", fuel: "natural_gas", amount: 45000, unit: "kwh" },
{ label: "Backup generator", fuel: "diesel", amount: 800, unit: "litre" },
{ label: "Company vehicles", fuel: "petrol", amount: 3200, unit: "litre" },
{ label: "Warehouse heating", fuel: "lpg", amount: 2500, unit: "litre" },
];
const results = await Promise.all(
fuelConsumption.map(f =>
fetch(`https://api.emissions.dev/v1/fuel/emissions`
+ `?fuel_type=${f.fuel}&amount=${f.amount}&unit=${f.unit}`,
{ headers: { Authorization: `Bearer ${apiKey}` }}
).then(r => r.json())
)
);
// Office heating: 9,318 kg (natural gas)
// Backup generator: 2,522 kg (diesel)
// Company vehicles: 8,390 kg (petrol)
// Warehouse heating: 4,527 kg (LPG)
// Total Scope 1: 24,757 kg CO₂e
Biofuel Transition Modelling
Compare fossil fuel emissions against biofuel alternatives. Show clients exactly how much switching to HVO or biodiesel would save.
- Biogenic CO₂ correctly reported as zero
- Only CH₄ and N₂O counted for biofuels
- Side-by-side fossil vs biofuel comparison
# Compare diesel against HVO (renewable diesel)
import requests
fuels = [
{"fuel_type": "diesel", "label": "Diesel"},
{"fuel_type": "hvo", "label": "HVO"},
]
for f in fuels:
resp = requests.get(
"https://api.emissions.dev/v1/fuel/emissions",
headers={"Authorization": f"Bearer {API_KEY}"},
params={
"fuel_type": f["fuel_type"],
"amount": 1000,
"unit": "litre",
}
)
data = resp.json()["data"]["attributes"]
co2e = data["emissions"]["co2e"]
print(f"{f['label']:10} {co2e:,.1f} kg CO₂e")
# Diesel 3,152.5 kg CO₂e
# HVO 38.2 kg CO₂e ← 98.8% reduction
#
# ℹ️ HVO: Biogenic CO₂ = zero. Only CH₄ + N₂O counted.
Energy & Facility Management
Add carbon intelligence to energy management dashboards. Show clients their heating, generator, and vehicle emissions alongside consumption data.
- Well-to-Tank upstream emissions included
- Natural gas in kWh, therms, or m³
- Coal triggers decarbonisation advice
- Fuel type lookup endpoint for discovery
# Same gas bill, different units
$ curl "https://api.emissions.dev/v1/fuel/emissions?\
fuel_type=natural_gas&amount=500&unit=therm"
{ "co2e": 3,035.5, "unit": "therm" }
$ curl "https://api.emissions.dev/v1/fuel/emissions?\
fuel_type=natural_gas&amount=14652&unit=kwh"
{ "co2e": 3,035.5, "unit": "kwh" }
# Same result — use whichever unit your bill shows
# Browse all available fuels:
$ curl "https://api.emissions.dev/v1/fuel/types"
# Returns 16 fuels with available units
$ curl "https://api.emissions.dev/v1/fuel/types?\
category=biofuel"
# Returns biodiesel, HVO, bioethanol, wood, biogas
Audit-ready methodology
DEFRA 2025 emission factors with individual gas breakdown.
Every response includes a full audit trail traceable to source data.
GHG Protocol Scope 1
Direct combustion emissions calculated per the GHG Protocol Corporate Standard for stationary and mobile sources.
Gas-by-Gas Breakdown
Every response includes individual CO₂, CH₄, and N₂O values — not just the aggregated CO₂e. Required for detailed GHG inventories.
Well-to-Tank Included
Upstream fuel extraction and refining emissions (Scope 3 Category 3) included by default. Toggle with include_wtt.
Biofuel Aware
Biogenic CO₂ correctly excluded from Scope 1 per GHG Protocol guidance. Clear notices explain the methodology.
{
"co2e": 3152.5,
"co2e_unit": "kg",
"breakdown": {
"direct_co2e": 2512.1,
"direct_co2": 2494.6,
"direct_ch4": 0.11,
"direct_n2o": 16.4,
"wtt_co2e": 640.4
},
"ghg_protocol_scopes": {
"scope_1": 2512.1,
"scope_3_category_3": 640.4
},
"fuel": {
"fuel_type": "diesel",
"emission_factor": 2.5121,
"emission_factor_unit": "kgCO2e/litre"
},
"source_trail": [
{ "source": "DEFRA 2025", "dataset": "GHG Conversion Factors" }
]
}
Fuel types lookup endpoint
Browse all supported fuel types with our dedicated
/v1/fuel/types endpoint. Filter by category to find the right fuel type for your data.
DEFRA 2025
Filterable
Per fuel type
Avg response
Integrate in minutes
Simple REST API. Just fuel type, amount, and unit.
Get your API key
Sign up and get your key instantly. No approval process, no sales calls.
Pass fuel + amount
Choose from 16 fuel types. Unit is optional — defaults to the most common for each fuel.
Get CO2e in JSON
Scope 1 breakdown with individual gas species, audit trail, and WTT separation in every response.
Fuel API FAQ
Common questions about fuel combustion emissions calculations.
We support 16 fuel types across four categories:
- Gaseous — Natural gas, LPG, CNG, biogas
- Liquid — Diesel, petrol, kerosene, fuel oil, red diesel (gas oil)
- Biofuel — Biodiesel (B100/FAME), HVO, bioethanol, wood logs, wood pellets
- Solid — Coal (industrial), coal (domestic)
Use the /v1/fuel/types endpoint to browse all supported fuels with their available units.
Available units vary by fuel type to match how fuel is commonly purchased and metered:
- Natural gas — kWh, therms, or m³
- Liquid fuels — litres or kWh
- LPG — litres, kWh, or kg
- Solid fuels — kg or kWh
The unit parameter is optional — if omitted, the API defaults to the most common unit for each fuel type (kWh for gas, litres for liquids, kg for solids).
Per GHG Protocol and DEFRA methodology, direct CO₂ from biofuel combustion is classified as biogenic and excluded from Scope 1 totals. This is because the carbon was recently absorbed from the atmosphere by the biomass.
The co2e figure for biofuels represents only CH₄ (methane) and N₂O (nitrous oxide) emissions from incomplete combustion. However, upstream (Well-to-Tank) emissions are still included by default and can be significant — for example, bioethanol WTT is 0.618 kgCO₂e/litre.
The response includes a biofuel_biogenic_carbon notice explaining this methodology whenever a biofuel is requested.
Many GHG reporting frameworks require individual gas species to be reported separately, not just the aggregated CO₂e total. This is particularly important for:
- National inventory reporting — requires individual gas quantities
- ISO 14064 compliance — specifies separate gas reporting
- CSRD ESRS E1 — expects granular emissions data
The aggregated CO₂e uses IPCC AR6 GWP100 values (CH₄ = 27.9, N₂O = 273) to convert all gases to a single carbon dioxide equivalent.
All factors are sourced from the UK Government GHG Conversion Factors 2025 (commonly known as DEFRA factors), published by the Department for Energy Security and Net Zero (DESNZ).
Direct combustion factors come from Table 1 (Fuels). Well-to-Tank factors come from Table 2 (WTT Fuels). All CO₂e values use IPCC AR6 GWP100 values.
Every response includes a source_trail referencing the specific DEFRA dataset and factor used.
Yes. DEFRA factors are the standard source for UK corporate reporting under Streamlined Energy and Carbon Reporting (SECR) and are widely used for EU CSRD compliance. Scope 1 fuel combustion is mandatory under:
- UK SECR — Streamlined Energy and Carbon Reporting
- EU CSRD — European Sustainability Reporting Standards (ESRS E1)
- California SB 253 — Climate Corporate Data Accountability Act
- CDP — Carbon Disclosure Project questionnaire
The individual gas breakdown (CO₂, CH₄, N₂O) and DEFRA source trail satisfy assurance provider requirements.
Absolutely — that's the idea. Together, our APIs cover the full GHG reporting stack:
- Fuel API — Scope 1 (this endpoint)
- Electricity API — Scope 2 (purchased electricity)
- Freight API — Scope 3 Category 4 & 9 (transport)
- Travel API — Scope 3 Category 6 (business travel)
- Hotel API — Scope 3 Category 6 (accommodation)
One provider, all three scopes. Complete corporate carbon footprint from a single API key.
Both have identical emission factors (2.5121 kgCO₂e/litre) since they're chemically the same fuel. Red diesel (gas oil) is rebated diesel used for off-road purposes — agriculture, construction, generators, and heating.
We include both as separate fuel types so your reports correctly label the fuel source. Red diesel use may have different tax and regulatory reporting requirements depending on your jurisdiction.
Complete your Scope 1 reporting
Get your API key in 30 seconds. 500 free requests per month. No credit card required.