Emission Calculators
Calculate CO₂e emissions for business and operational activities.
Flight Travel Estimates
Emissions from Business Flight Travel
Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) for business travel through flights/air, based on airport codes of arrival and departure, class of flight and number of passengers.
This calculation is used for reporting Scope 3 emissions for individuals flying for work purposes. The footprint of a flight travel is calculated based on the distance between airports and the travelling class of the passenger.
operationId: calculate_emissions_from_business_flight_travel
Notes
-
If there are two passengers in the same flight, but sitting in different classes then two separate API calls are suggested, one for each passenger.
-
As the ICAO does not apply the radiative forcing (RF) multiplier (accounting for the wider climate effect of emissions arising from aircraft transport at altitude) or distance uplift factor to account for delays/circling and non-direct routes (i.e., not along the straight-line/great-circle between destinations), we have added an option for you to factor it in the calculation. Use the "add_rf" field to add this factor.
-
WTT (well-to-tank) emissions consist of all processes between the source of the fuel (the well) through the extraction, processing (refining), storage and delivery phases up until the point of use (the tank) in the plane before take-off. Using the "include_wtt" field will add the upstream emission associated with this flight in the estimation.
query Parameters
iata_airport_from^[A-Za-z]{3}$ · requiredThe departing airport's IATA airport code (The unique 3 digit geocode, also known as IATA location identifier, IATA station code, or location identifier)
iata_airport_to^[A-Za-z]{3}$ · requiredThe arrival airport's IATA airport code (The unique 3 digit geocode, also known as IATA location identifier, IATA station code, or location identifier)
flight_classThe class in which the passenger is travelling. Allowed: [Economy, Premium, Business, First]. It is optional. For NULL or undefined values, an Average factor is used.
round_tripThe default value of "Y" means that the traveller has taken the flight from origin to destination and then back to the same origin in the same class, while a "N" means a one-way journey.
number_of_passengersDefault: 1. If a NULL or <0 is entered, it is set to 1
add_rfThe default value of "Y" adds the radiative forcing multiplier factor in the footprint calculation; "N" bypasses it
include_wttThe default value of "Y" includes the Well-to-Tank (WTT) factors while "N" bypasses it
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
Flight Travel Estimates › Responses
Estimated flight emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Hotel Stay Emission Estimates
Emissions from Hotel Stay
Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) based on country of hotel, length of stay, room count, and hotel star rating.
CarbonSutra's approach for calculating the carbon footprint of hotel stays is based on Cornell Hotel Sustainability Benchmark Index and UK government's GHG conversion factors published in 2026.
operationId: calculate_emissions_from_hotel_stay
query Parameters
country_codeTwo digit ISO 3166-1 alpha-2 country code
city_nameCity of hotel within the country
hotel_ratingExpedia star classification rating of the hotel. Allowed: [2-5], Default: 4
number_of_nightsLength of stay in nights. Default: 1
number_of_roomsNumber of rooms booked, irrespective of count of persons per room. Default: 1
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
Hotel Stay Emission Estimates › Responses
Estimated hotel-stay emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Electricity Usage Estimates
Emissions from Electricity Usage
Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) from electricity usage based on coutnry name and units of electricity consumed.
Data from nearly 90 countries for years 2020, 2024 and 2026, from multiple sources has been compiled.
operationId: calculate_emissions_from_electricity_usage
query Parameters
country_nameName of the country for which the emission is being measured.
electricity_unitElectricity unit of consumption. Allowed values: [KWh, MWh]. Default: MWh
electricity_valueNumber of units of electricity consumed. If an undefined value is passed, it will be set to 1.00
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
Electricity Usage Estimates › Responses
Estimated electricity emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Fuel Combustion Estimates
Emissions from Fuel Consumption
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 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
query Parameters
fuel_usageFuel usage or activity. Allowed: ["Gas", "Liquid", "Solid"]
fuel_nameThe 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_valueThe amount of fuel that is consumed in number of tonnes. Default is 1.00
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
Fuel Combustion Estimates › Responses
Estimated fuel emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Freight Shipping Estimates
Emissions from Freight Shipping
Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) for freight shipments through Road, Rail, Air and Sea (categorized into Short Sea and Deep Sea).
Two additional calculations for Intermodal shipping are available: 1) Road with Rail and 2) Road with Short Sea. In both cases, the road distance is assumed to be 10% of the entire journey.
operationId: calculate_emissions_from_shipment_of_freight
query Parameters
transport_modeThe mode of shipment of freight. Deep sea (value: DeepSea) shipping refers to the maritime transport of goods on intercontinental routes, crossing oceans as opposed to short sea (value: ShortSea) shipping over relatively short distances. For Intermodal shipping of 1) Road with Rail and 2) Road with Short Sea, the road distance is assumed to be at 10% of the entire journey.
freight_weightWeight of freight in kilograms. If a NULL or <=0 is entered, it is set to 1.00
distance_valueDistance of journey in kilometers (KM). If a NULL or <=0 is entered, it is set to 1.00
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
Freight Shipping Estimates › Responses
Estimated freight emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
eCommerce Shipment Estimates
Emissions from eCommerce Shipments
Returns estimated greenhouse gas emissions (CO2e) in multiple units (grams, kilograms, metric tons, pounds) for eCommerce shipments.
This is an advanced algorithm to estimate the emissions of a package's journey from its shipment location to the collection point. If the distance between two postal codes is above a threshold, we find the nearest airports from the origin and then from the destination location. The final distance of journey is then a sum of the distance between the origin postal code and nearest airport by land, air travel between the airports closest to the origin and the destination and finally, land travel between destination airport and postal code of collection point by land. The final calculation follows ECTA/Cefic and BEIS/DEFRA's recommended conversion factors and works on a database of over 1.5 million postal codes across 95 countries and 9,000 global airports.
operationId: calculate_emissions_from_ecommerce_shipment
query Parameters
origin_country_codeTwo letter ISO country code of the origin, ie from where the package is being sent
origin_postal_codeThe postal code within the origin country from where the package is being shipped
destination_country_codeTwo letter ISO country code of the destination, ie to where the package is being sent
destination_postal_codeThe postal code within the destination country to where the package is being shipped
package_weightWeight of package in kilograms. If a NULL or <=0 is entered, it is set to 1.00
add_rfThe default value of "Y" adds the radiative forcing multiplier factor in the footprint calculation; "N" bypasses it
include_wttThe default value of "Y" includes the Well-to-Tank (WTT) factors while "N" bypasses it
cluster_nameIdentifier to log and aggregate results under the Cluster Data API
eCommerce Shipment Estimates › Responses
Estimated eCommerce shipment emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.