Copy page

Estimation APIs

Emissions from Fuel Combustion

Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) based on usage, fuel name and its value in tonnes.

CarbonSutra computes the emissions from stationary combustion of fuels which are burnt in a fixed unit or asset owned or controlled by the reporting organization, and usually reported as a Scope 1 direct emission. The source of data and methodology of emission factor calculation are from UK government's GHG conversion factors of 2026.

operationId: calculate_emissions_from_fuel_consumption

Payload Specification

Field	Type	Required	Default	Description	Example
fuel_usage	String	Yes	-	Fuel usage or activity. Allowed: [gas, liquid, solid]	liquid
fuel_name	String	Yes	-	The fuel name is based on value of fuel usage field. Only the following values are allowed: - For fuel_usage = "gas", the allowed values for fuel_name are: [Butane, CNG, LNG, LPG, Natural gas, Natural gas (100% mineral blend), Other petroleum gas, Propane] - For fuel_usage = "liquid", the allowed values for fuel_name are: [Aviation spirit, Aviation turbine fuel, Burning oil, Diesel (100% mineral diesel), Diesel (average biofuel blend), Fuel oil, Gas oil, Lubricants, Marine fuel oil, Marine gas oil, Naphtha, Petrol (100% mineral petrol), Petrol (average biofuel blend), Processed fuel oils - distillate oil, Processed fuel oils - residual oil, Refinery miscellaneous, Waste oils] - For fuel_usage = "solid", the allowed values for fuel_name are: [Coal (domestic), Coal (electricity generation - home produced coal only), Coal (electricity generation), Coal (industrial), Coking coal, Petroleum coke]	Fuel oil
fuel_value	Number	Yes	-	The amount of fuel that is consumed in number of tonnes.	2360
cluster_name	String	No	-	Identifier to log and aggregate these results under using the Cluster Data API	KrugerBrent_Entity3_2026

Example

Request Payload

Code
import http.client
conn = http.client.HTTPSConnection("carbonsutra1.p.rapidapi.com")
payload = "fuel_usage=gas&fuel_name=lpg&fuel_value=2235&cluster_name="
headers = {
    'x-rapidapi-key': "37db609019mshdc94f05512b7a5dp1fe7f5jsned8090189a51",
    'x-rapidapi-host': "carbonsutra1.p.rapidapi.com",
    'Content-Type': "application/x-www-form-urlencoded",
    'Authorization': "Bearer fQ98oU704xFvsnXcQLVDbpeCJHPglG1DcxiMLKfpeNEMGumlbzVf1lCI6ZBx"
}
conn.request("POST", "/fuel_estimate", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Response Payload

Code
{
  "data": {
    "type": "estimate-fuel",
    "fuel_usage": "gas",
    "fuel_name": "lpg",
    "fuel_unit": "tonnes",
    "fuel_value": "2235",
    "co2e_gm": 6569471723,
    "co2e_kg": 6569471.72,
    "co2e_mt": 6569.47,
    "co2e_lb": 14483188.74
  },
  "success": true,
  "status": 200
}

Notes

1. These emissions could be reported as Scope 3 indirect emissions if the organization does not own or control the asset (eg, a boiler) where the combustion takes place.
2. Fuels conversion factors should be used for primary fuel sources combusted at a site or in an asset owned or controlled by the reporting organisation.