Emission Calculators
Calculate CO₂e emissions for business and operational activities.
Calculate business flight emissions
Calculates estimated CO₂e emissions for business air travel using departure and arrival airports, cabin class, passenger count, and trip type. Optional radiative-forcing (RF) and Well-to-Tank (WTT) factors can be included.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
iata_airport_from^[A-Za-z]{3}$ · requiredThree-letter IATA code of the departure airport.
iata_airport_to^[A-Za-z]{3}$ · requiredThree-letter IATA code of the arrival airport.
flight_classCabin class. If omitted, the API may use its average factor.
round_tripSet to Y for a round trip and N for a one-way trip. Default: Y.
number_of_passengersNumber of passengers. Values below 1/default are treated as 1.
add_rfControls inclusion of the radiative-forcing multiplier. Default: Y.
include_wttControls inclusion of Well-to-Tank (WTT) emissions. Default: Y.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate business flight emissions › Responses
Estimated flight emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Calculate hotel-stay emissions
Calculates estimated CO₂e emissions for hotel accommodation using country, optional city, hotel rating, number of nights, and number of rooms.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
country_codeTwo-digit ISO 3166-1 alpha-2 country code.
city_nameCity of hotel within the country.
hotel_ratingExpedia star classification. Default is 4.
number_of_nightsLength of stay in nights. Default is 1.
number_of_roomsNumber of rooms booked. Default is 1.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate hotel-stay emissions › Responses
Estimated hotel-stay emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Calculate electricity-consumption emissions
Calculates estimated CO₂e emissions from electricity consumption using the selected country, consumption unit, and quantity.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
country_nameCountry for which emissions are measured.
electricity_unitElectricity consumption unit. Default is MWh.
electricity_valueElectricity consumed. Undefined values are treated as 1.00.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate electricity-consumption emissions › Responses
Estimated electricity emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Calculate fuel-consumption emissions
Calculates estimated CO₂e emissions from fuel consumption. The permitted fuel names depend on whether the activity is classified as gas, liquid, or solid fuel.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
fuel_usageFuel usage/activity category.
fuel_nameFuel name. Allowed values depend on fuel_usage: gas: Butane, CNG, LNG, LPG, Natural gas, Natural gas (100% mineral blend), Other petroleum gas, Propane. liquid: 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. solid: Coal (domestic), Coal (electricity generation - home produced coal only), Coal (electricity generation), Coal (industrial), Coking coal, Petroleum coke.
fuel_valueAmount of fuel consumed, in tonnes.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate fuel-consumption emissions › Responses
Estimated fuel emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Calculate freight-shipment emissions
Calculates estimated CO₂e emissions for freight transportation using transport mode, freight weight, and journey distance. Road, rail, air, sea, and intermodal calculations are supported.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
transport_modeFreight transport mode, including Road, Rail, Air, ShortSea, DeepSea and intermodal options.
freight_weightFreight weight in kilograms.
distance_valueJourney distance in kilometres.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate freight-shipment emissions › Responses
Estimated freight emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.
Calculate eCommerce shipment emissions
Calculates estimated CO₂e emissions for an eCommerce package journey using origin and destination countries and postal codes, package weight, and optional RF/WTT factors.
Request format: The supplied CarbonSutra API collection defines the calculation inputs as query parameters for this POST endpoint.
query Parameters
origin_country_codeTwo-letter ISO country code of origin.
origin_postal_codeOrigin postal code.
destination_country_codeTwo-letter ISO country code of destination.
destination_postal_codeDestination postal code.
package_weightPackage weight in kilograms.
add_rfControls inclusion of the radiative-forcing multiplier. Default: Y.
include_wttControls inclusion of Well-to-Tank (WTT) emissions. Default: Y.
cluster_nameOptional developer-defined label used to associate the calculation with an emission cluster.
Calculate eCommerce shipment emissions › Responses
Estimated eCommerce shipment emissions.
CO₂e result returned by an emission calculator.
successWhether the request completed successfully.
statusAPI status value.