API Reference

Climatiq helps you calculate the environmental footprint created by a broad range of emission-generating activities.

We simplify the process of converting your operational activity data into CO2e (carbon dioxide equivalent) estimates, allowing you to understand your impact on the environment and identify actions to manage and reduce it.

Operational activity data can be generated from any actions that result in greenhouse gas emissions, including vehicle rides, energy consumption, flights, logistical operations, manufacturing, agriculture, heating or cooling of buildings, and countless other daily activities.

Using the Climatiq REST API, you can take data from your software and systems and automatically transform that it into CO2e values, using emission factors from a range of validated sources available in the Open Emission Factor Database (OEFDB).

The Climatiq API is designed to help developers build tools to automate calculation of the environmental impact of any business or organisation's activity.

The API is organized around REST. It has predictable resource-oriented URLs; accepts JSON-encoded request bodies; returns JSON-encoded responses; and uses standard HTTP response codes, authentication, and verbs. To help maintain security, all requests must be made over HTTPS. Calls made over plain HTTP will fail.

https://beta3.api.climatiq.io

An emission factor is a value that estimates the quantity of a gas with a global warming potential (GWP) released into the atmosphere, per some unit related to a particular activity.

For example:

  • electricity-energy_source_grid_mix: Energy consumed using grid electricity, measured in kWh.
  • flight-domestic: Domestic airplane flight, calculated using distance or airport codes.
  • freight_vehicle-vehicle_type_hgv: Transportation of goods on a heavy goods vehicle, measured using weight in kilograms, tonnes (metric tons) or tons (US short tons) and distance in kilometers or miles.

Authenticate the app using API keys as bearer tokens. Always provide the Authorization header containing your API KEY as bearer token:

Authorization: Bearer <API_KEY>

Note: Your API keys carry many privileges, so be sure to keep them secure. Do not share your API keys in publicly accessible areas such as GitHub or through client-side code. When possible, encrypt API keys when you store them.

Having trouble? Find out how to get API keys here or follow our quickstart guide here.

The Climatiq API uses conventional HTTP response codes to indicate the success or failure of an API request.

200 OK: Everything worked as expected.

400 Bad Request: The request was unacceptable, probably due to missing a required parameter.

401 Unauthorized: No valid API key was provided.

404 Not Found: The requested resource doesn't exist.

5xx Server Errors: Something went wrong on our servers.

To enable compression, define an Accept-Encoding header with the value gzip for gzip compression or br for brotli compression.

Accept-Encoding: gzip

Estimation operations are performed to calculate emissions produced by one or more activities, based on multiplying activity data by the appropriate emission factors.

POST Calculate total estimated emissions produced for a particular activity, in `kgCO2e``, using the available emission factors. All requests are performed by sending a POST request to the following endpoint:

https://beta3.api.climatiq.io/estimate

The method of calculating emission estimates can differ depending on the unit type that the factor accepts and the applicability of the emission factor as indicated in the ID, name and description fields, with further detail provided by the source.

Every factor is linked to a unit type that is specified in the emission factors list inside the unit_type attribute. See all available emission factors in our Data Explorer.

The following parameters can be defined as JSON-encoded body.

curl --request POST \
--url https://beta3.api.climatiq.io/estimate \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "heat-and-steam-type_purchased",
"parameters": {
"energy": 100,
"energy_unit": "kWh"
}
}'

This endpoint returns an Estimation, which includes the total amount of emissions in kgCO2e and the emission factor used to calculate the emissions.

{
"co2e": 22.65504025,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"id": "heat-and-steam-type_purchased",
"source": "EPA",
"year": "2021",
"region": "US",
"category": "Heat and Steam",
"lca_activity": "unknown"
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 22.631796,
"ch4": 0.0004265,
"n2o": 0.00004265
}
}

POST Batch estimations can be used to calculate multiple emission estimations in a single request. Currently limited to maximum 100 operations per request.

https://beta3.api.climatiq.io/batch

curl --request POST \
--url https://beta3.api.climatiq.io/batch \
--header 'Authorization: Bearer API_KEY' \
--data '[
{
"emission_factor": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"parameters":{
"distance": 100,
"distance_unit": "km"
}
},
{
"emission_factor": "consumer_goods-type_snack_foods",
"parameters": {
"money": 15,
"money_unit": "usd"
}
}
]'

The response includes a list of Estimations.

{
"results": [
{
"co2e": 20.756966813807363,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Vehicles",
"lca_activity": "use_phase"
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 20.629523582279486,
"ch4": 0.00043495983456613376,
"n2o": 0.00043495983456613376
}
},
{
"co2e": 3.69,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "consumer_goods-type_snack_foods",
"source": "EPA",
"year": "2020",
"region": "US",
"category": "Food/Beverages/Tobacco",
"lca_activity": "cradle_to_shelf"
},
"constituent_gases": {
"co2e_total": 3.69,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}
]
}

If one or more estimations fail, the result will contain an error code and message for every unsuccessful operation:

{
"results": [
# Successful operation
{
"co2e": 20.756966813807363,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Vehicles",
"lca_activity": "use_phase"
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 20.629523582279486,
"ch4": 0.00043495983456613376,
"n2o": 0.00043495983456613376
}
},
# Failed operation
{
"error": "not_found",
"message": "No emission factors could be found using the current query."
}
]
}

In addition to direct calculation of emissions per passenger-kilometer, passenger-mile, tonne-kilometer or ton-mile, Climatiq makes endpoints available for calculating emissions based on departure and arrival airports. The API will automatically select an emission factor, currently based on choosing the highest available CO2e value; a specific ID can be selected to override this.

POST Calculate total estimated emissions produced by passenger flights between the specified airports

https://beta3.api.climatiq.io/travel/flights

The following parameters can be defined as JSON-encoded object in a body.

Flight legs are the constituent elements of a given flight from one location to another; e.g. a flight from Berlin to New York JFK might require 2 legs of Berlin to Hamburg and Hamburg to New York JFK

# First class trip from Berlin to Hamburg for two passengers.
# Followed by a trip from Hamburg to New York JFK for two passengers in economy class.
curl --request POST \
--url https://beta3.api.climatiq.io/travel/flights \
--header 'Authorization: Bearer API_KEY' \
--data '{
"legs": [
{
"from": "BER",
"to": "HAM",
"passengers": 2,
"class": "first"
},
{
"from": "HAM",
"to": "JFK",
"passengers": 2,
"class": "economy"
}
]
}'

The response includes the total emissions for the trip in kgCO2e, and the emissions for each leg of the trip.

{
"co2e": 2086.8196654786484,
"co2e_unit": "kg",
"legs": [
{
"co2e": 116.866091874,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "passenger_flight-route_type_domestic-aircraft_type_na-distance_na-class_na-rf_na",
"source": "UBA",
"year": "2020",
"region": "DE",
"category": "Air Travel",
"lca_activity": "upstream-fuel_combustion"
},
"constituent_gases": {
"co2e_total": 116.866091874,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 1969.9535736046485,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "passenger_flight-route_type_na-aircraft_type_na-distance_gt_2300mi-class_na-rf_na",
"source": "EPA",
"year": "2021",
"region": "US",
"category": "Air Travel",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": 1969.9535736046485,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}
]
}

POST Calculate total estimated emissions produced by freight flights between the specified airports

https://beta3.api.climatiq.io/freight/flights

The following parameters can be defined as JSON-encoded object in a body.

Flight legs are the constituent elements of a given flight from one location to another; e.g. a flight from Berlin to New York JFK might require 2 legs of Berlin to Hamburg and Hamburg to New York JFK

# Trip from Berlin to Hamburg with 100 tonnes of cargo.
# Followed by a trip from Hamburg to New York JFK of 30 tonnes of cargo.
curl --request POST \
--url https://beta3.api.climatiq.io/freight/flights \
--header 'Authorization: Bearer API_KEY' \
--data '{
"legs": [
{
"from": "BER",
"to": "HAM",
"weight": 0.5,
"weight_unit": "t"
},
{
"from": "HAM",
"to": "JFK",
"weight": 0.5,
"weight_unit": "t"
}
]
}'

The response includes the total emissions for the trip in kgCO2e, and the emissions for each leg of the trip.

{
"co2e": 2926.1170826710186,
"co2e_unit": "kg",
"legs": [
{
"co2e": 163.228461655,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "freight_flight-route_type_domestic-distance_na-weight_na-rf_na",
"source": "UBA",
"year": "2020",
"region": "DE",
"category": "Air Freight",
"lca_activity": "upstream-fuel_combustion"
},
"constituent_gases": {
"co2e_total": 163.228461655,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 2762.8886210160185,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "freight_flight-route_type_na-distance_na-weight_na-rf_na",
"source": "GHG Protocol",
"year": "2021",
"region": "US",
"category": "Air Freight",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": 2762.8886210160185,
"co2e_other": null,
"co2": 2740.56807688524,
"ch4": 0.0,
"n2o": 84.22846841803259
}
}
]
}

Climatiq makes endpoints available to help you calculate the carbon footprint of the cloud resources you use. It will automatically select emission factors based on your cloud provider and region, so you get the right emission factor for your datacenter.

All the cloud computing endpoints expect you to provide the cloud provider in the url. Where the urls state :provider you must replace it with a supported cloud provider. Currently, the supported cloud providers are gcp, azure and aws.

CPU ALPHA

POST Calculate total estimated emissions based on the usage for a set number of virtual CPU's (vCPUs)

https://beta3.api.climatiq.io/compute/:provider/cpu

Where the :provider path argument must be replaced with one of the supported cloud providers.

The following parameters can be defined as a JSON-encoded object in a body.

curl --request POST
--url https://beta3.api.climatiq.io/compute/azure/cpu
--header 'Authorization: Bearer YOUR_API_KEY
--data '{
"cpu_count": 1,
"region": "uk_west",
"cpu_load": 1,
"duration": 1,
"duration_unit": "h"
}'

You will get an Estimation back with the co2e for the power consumption for the allocated memory for the given duration.

{
"co2e": 0.00057841,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "cpu-provider_azure-region_uk_west",
"source": "CCF",
"year": "2021",
"region": "GB-CDF",
"category": "Cloud Computing - CPU",
"lca_activity": "usephase"
},
"constituent_gases": {
"co2e_total": 0.00057841,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

POST Calculate total estimated emissions based on storing data for a set amount of time.

https://beta3.api.climatiq.io/compute/:provider/storage

Where the :provider path argument must be replaced with one of the supported cloud providers.

The following parameters can be defined as a JSON-encoded object in a body.

AttributesRequiredDefault
curl --request POST
--url https://beta3.api.climatiq.io/compute/aws/storage
--header 'Authorization: Bearer YOUR_API_KEY
--data '{
"region": "af_south_1",
"storage_type": "ssd",
"data": 50,
"data_unit": "GB",
"duration": 1,
"duration_unit": "day"
}'

You will get an Estimation back with the CO2e for the storage of the data for the given duration.

{
"co2e": 0.0015167280000000004,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "storage-provider_aws-region_af_south_1-type_ssd",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Cloud Computing - Storage",
"lca_activity": "usephase"
},
"constituent_gases": {
"co2e_total": 0.0015167280000000004,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Memory ALPHA

POST Calculate total estimated emissions based on having memory (RAM) available for a set amount of time.

https://beta3.api.climatiq.io/compute/:provider/memory

Where the :provider path argument must be replaced with one of the supported cloud providers.

The following parameters can be defined as a JSON-encoded object in a body.

curl --request POST
--url https://beta3.api.climatiq.io/compute/gcp/memory
--header 'Authorization: Bearer YOUR_API_KEY
--data '{
"region": "us_west_2",
"data": 8,
"data_unit": "GB",
"duration": 24,
"duration_unit": "h"
}'

You will get an Estimation back with the co2e emitted by having the allocated memory available for the given duration.

{
"co2e": 0.02053248,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "memory-provider_gcp-region_us_west_2",
"source": "CCF",
"year": "2021",
"region": "US-LAX",
"category": "Cloud Computing - Memory",
"lca_activity": "usephase"
},
"constituent_gases": {
"co2e_total": 0.02053248,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Many sources link emission factors to specific industry classification schemes, and Climatiq makes it possible to select an emission factor based on these industry classification codes. Please see below the list of mappings we currently support, with the datasets that are mapped directly to them (note that the API will also map factors indirectly via the UN correspondence tables):

For a more in-depth view on how Climatiq works with classification schemes, view the classification guide.

POST Calculate total estimated emissions produced for a particular activity, as described by an industry classification scheme such as ISIC or NACE. All requests are performed by sending a POST request to the following endpoint:

https://beta3.api.climatiq.io/classifications/estimate

This endpoint lets you specify an industry classification code and have Climatiq automatically select the appropriate emission factor.

One industry code might be linked to more than one emission factor. If that happens, Climatiq will automatically select the most conservative emission factor. If you would like to specify exactly what emission factor to use, you can specify other attributes to filter on, such as year, source or region.

Industry classification codes can also be mapped to each other using the UN correspondence tables, allowing Climatiq to return emission factors from other classification schemes that represent the same activity if there isn't one found directly; this may happen for example because of different classification taxonomies being used in different geographies or by different data sources.

As with any estimation endpoint, the emission factor must be provided with parameters, such as weight, volume, energy. These are provided through the parameters field. See the estimate endpoint for more details on how parameters and units work.

The following parameters can be defined as JSON-encoded object in a body.

The Classification Selector is very reminiscent of a Selector with a few differences. It is an object consisting of the following parameters:

AttributeRequired
curl --request POST \
--url https://beta3.api.climatiq.io/classifications/estimate \
--header 'Accept-encoding: gzip' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"classification": {
"classification_type": "isic4",
"classification_code": "25",
"source": "EXIOBASE"
},
"parameters": {
"money": 25.0,
"money_unit": "usd"
}
}'

This endpoint returns an Estimation, which includes the total amount of emissions in kgCO2e and the emission factor used to calculate the emissions.

{
"co2e": 5.427601772895001,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "metal_products-type_fabricated_metal_products_except_machinery_equipment",
"source": "EXIOBASE",
"year": "2021",
"region": "DE",
"category": "Fabricated Metal Products",
"lca_activity": "unknown"
},
"constituent_gases": {
"co2e_total": 5.427601772895001,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Instead of using code to specify emission factors you want to use for your calculations, you can map your own activity identifiers to Climatiq IDs in the Climatiq dashboard, allowing the Climatiq API to recognize whatever values you use to categorize your activities. In the dashboard simply link a custom activity label to an emission factor id, and this can then be used in the custom activities endpoints.

This means you can add and manage how your activities map to emission factors without having to update your code. View the how-to guide to be taken step-by-step through mapping custom activities and performing queries.

POST Calculate total estimated emissions produced for a particular activity in kgCO2e using a custom activity that you have defined under the Activity Mapping tab inside your Climatiq Dashboard.

A custom activity label provides the same flexibility as the ID it maps to. This can happen when multiple emission factors share an emission factor id or because you have mapped the same custom activity to different emission factor ids.

You can provide parameters to select emission factors by filtering using year, region, data source and more as described in our selector section. If there are multiple emission factors Climatiq will automatically pick the most conservative one.

https://beta3.api.climatiq.io/custom-activities/estimate

The following parameters can be defined as JSON-encoded body.

The Custom Activity Selector is very reminiscent of a Selector with a few differences. It is an object consisting of the following parameters:

AttributeRequired
# In this example, you have already specified "Hotels and accommodation" as a custom activity in the dashboard
# and linked it to an emission factor that use the Money unit.
curl --request POST \
--url https://beta3.api.climatiq.io/custom-activities/estimate \
--header 'Authorization: Bearer API_KEY' \
--data '{
"custom_activity": {
"label": "Hotels and accommodation",
"region": "GB"
},
"parameters": {
"money": 100,
"money_unit": "gbp"
}
}'

You will get an Estimation back with the CO2e for the given custom activity, based on the id that it is mapped to in the Activity Mapping tool in the Climatiq Dashboard.

{
"co2e": 42.5,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "accommodation_type_holiday",
"source": "BEIS",
"year": "2018",
"region": "GB",
"category": "Accommodation",
"lca_activity": "unknown"
},
"constituent_gases": {
"co2e_total": 42.5,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

POST Batch estimations for custom activities work like regular Batch Estimates, allowing you to calculate multiple emission estimations in a single request, all based on custom activities mapped in the Climatiq Dashboard. Currently limited to maximum 100 operations per request.

https://beta3.api.climatiq.io/custom-activities/batch

# In this example, you have already specified "Hotels and accommodation" and "Soda" as custom activities in the dashboard
# and linked them to emission factors that use the Money unit.
curl --request POST \
--url https://beta3.api.climatiq.io/custom-activities/batch \
--header 'Authorization: Bearer API_KEY' \
--data '[
{
"custom_activity": {
"label": "Hotels and accommodation",
"region": "GB"
},
"parameters": {
"money": 100,
"money_unit": "gbp"
}
},
{
"custom_activity": {
"label": "Soda"
},
"parameters": {
"money": 100
}
}
]'

The response includes a list of responses, like the regular batch endpoint.

{
"results": [
{
"co2e": 42.5,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "accommodation_type_holiday",
"source": "BEIS",
"year": "2018",
"region": "GB",
"category": "Accommodation",
"lca_activity": "unknown"
},
"constituent_gases": {
"co2e_total": 42.5,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 29.7,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "consumer_goods-type_soft_drinks_bottled_water_ice",
"source": "EPA",
"year": "2020",
"region": "US",
"category": "Food/Beverages/Tobacco",
"lca_activity": "cradle_to_shelf"
},
"constituent_gases": {
"co2e_total": 29.7,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}
]
}

The Climatiq API can be queried for emission factors in a number of ways, outlined below.

GET Allows you to determine what emission factors are available to be used in your estimates.

You can search for free-text queries with the query parameter, or filter by parameters such as category, source, region, year calculation_method, lca_activity or id.

If you are using the query parameter, the results will be returned in order of how well they match your free-text query.

This endpoint is paginated, and will return current_page and last_page so you can determine which page you are on. You switch pages by using the page query parameter.

https://beta3.api.climatiq.io/search

AttributeRequiredDefault
curl --request GET \
--url 'https://beta3.api.climatiq.io/search?query=light+duty+trucks&year=2021' \
--header 'Authorization: Bearer API_KEY'

The response includes a list of emission factors filtered by the request parameters above.


Every emission factor returned in the list is formed by the following properties:

Attribute
{
"current_page": 1,
"last_page": 4,
"total_results": 79,
"results": [
{
"id": "commercial_vehicle-vehicle_type_truck_light-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"name": "Light duty truck",
"category": "Vehicles",
"sector": "Transport",
"source": "GHG Protocol",
"source_link": "https://ghgprotocol.org/ghg-emissions-calculation-tool",
"uncertainty": null,
"year": "2021",
"region": "US",
"region_name": "United States",
"description": "Emission intensity of light duty truck. The primary source is EPA Emission Factors for Greenhouse Gas Inventories - Table 8 Business Travel and Employee Commuting - March 9 2018.",
"unit_type": [
"Distance"
],
"unit": "kg/mile",
"lca_activity": "fuel_combustion",
"supported_calculation_methods": [
"ar4",
"ar5"
],
"factor": 0.477302,
"factor_calculation_method": "ar5",
"factor_calculation_origin": "source",
"constituent_gases": {
"co2e_total": 0.477302,
"co2e_other": null,
"co2": 0.472,
"ch4": 0.019,
"n2o": 0.018
}
},
{...},
{...}
],
"possible_filters": {
"year": [
"2021"
],
"source": [
"ADEME",
"BEIS",
"EPA",
"GHG Protocol"
],
"region": [
{
"id": "EU",
"name": "European Union"
},
{
"id": "FR",
"name": "France"
},
{
"id": "GB",
"name": "United Kingdom"
},
{
"id": "GLOBAL",
"name": "Global"
},
{
"id": "US",
"name": "United States"
}
],
"category": [
"Air Freight",
"Air Travel",
"Fuel",
"Rail Travel",
"Road Freight",
"Vehicles"
],
"sector": [
"Energy",
"Transport"
],
"unit_type": [
"Distance",
"PassengerOverDistance",
"Volume",
"WeightOverDistance"
]
}
}

GET Not all emission factors have data for all years. This endpoint returns a list of years available for a given query.

https://beta3.api.climatiq.io/emission-factors/years

The request parameters are the same as for Emission Query

curl --request GET \
--url 'https://beta3.api.climatiq.io/emission-factors/years?source=BEIS' \
--header 'Authorization: Bearer API_KEY'

{
"results": ["2021", "2020", "2018"]
}

GET Climatiq aggregates several different sources for the same emission factors, as different organizations often come to different conclusions about how much an activity emits. This endpoint a list of sources available for a given query.

https://beta3.api.climatiq.io/emission-factors/sources

The request parameters are the same as for Emission Query

curl --request GET \
--url 'https://beta3.api.climatiq.io/emission-factors/sources?year=2021' \
--header 'Authorization: Bearer API_KEY'

{
"results": ["ADEME", "BEIS"]
}

GET Not all emission factors have data for all geographic regions. This endpoint returns a list of regions available for a given query.

https://beta3.api.climatiq.io/emission-factors/regions

The request parameters are the same as for Emission Query

curl --request GET \
--url 'https://beta3.api.climatiq.io/emission-factors/regions?year=2021' \
--header 'Authorization: Bearer API_KEY'


Every region contains:

{
"results": [
{
"id": "AT",
"name": "Austria"
},
{
"id": "BE",
"name": "Belgium"
},
{
"id": "DE",
"name": "Germany"
},
{
"id": "DK",
"name": "Denmark"
},
{
"id": "ES",
"name": "Spain"
}
]
}

GET Returns a list of categories available for a given query.

https://beta3.api.climatiq.io/emission-factors/categories

The request parameters are the same as for Emission Query

curl --request GET \
--url 'https://beta3.api.climatiq.io/emission-factors/categories?source=BEIS' \
--header 'Authorization: Bearer API_KEY'

{
"results": [
"Accommodation",
"Air Transport",
"Air Travel",
"Electricity",
"Fuel",
"Rail Transport",
"Rail Travel",
"Road Transport",
"Road Travel",
"Sea Transport",
"Sea Travel",
"Treatment",
"Vehicle"
]
}

GET Returns a list of sectors available for a given query.

https://beta3.api.climatiq.io/emission-factors/sectors

The request parameters are the same as for Emission Query

curl --request GET \
--url 'https://beta3.api.climatiq.io/emission-factors/sectors?source=BEIS' \
--header 'Authorization: Bearer API_KEY'

{
"results": ["Energy", "Transport"]
}

GET Returns a list of life cycle assessment(LCA) activities available for a given query.

https://beta3.api.climatiq.io/emission-factors/lca-activities

The request parameters are the same as for Emission Query

curl --request GET \
--url 'https://beta3.api.climatiq.io/emission-factors/lca-activities?source=BEIS' \
--header 'Authorization: Bearer API_KEY'

{
"results": [
"electricity_generation",
"end_of_life",
"fuel_combustion",
"gate_to_grave",
"transmission_and_distribution",
"unknown",
"upstream",
"use_phase",
"well_to_tank"
]
}

This endpoint has been deprecated because it returns every single emission factor available by default. This leads to a very long response, resulting in several megabytes of traffic transfered. If you must use this endpoint for now, enable compression to significantly reduce the data transfer.

GET Lists all available emission factors or queries with parameters such as category, source, region, year calculation_method, lca_activity or id to help determine what emission factors are available to be used in your estimation.

https://beta3.api.climatiq.io/emission-factors

AttributeRequiredDefault
curl --request GET \
--url 'https://beta3.api.climatiq.io/emission-factors?source=BEIS&year=2021' \
--header 'Authorization: Bearer API_KEY'

The response includes a list of emission factors filtered by the request parameters above.


Every emission factor returned in the list is formed by the following properties:

Attribute
{
"results": [
{
"id": "fuel_type_avgas-fuel_use_aviation",
"name": "Aviation fuel (avgas) WTT",
"category": "Fuel",
"sector": "Energy",
"source": "BEIS",
"source_link": "https://www.gov.uk/government/publications/greenhouse-gas-reporting-conversion-factors-2021",
"uncertainty": null,
"year": "2021",
"region": "GB",
"region_name": "United Kingdom",
"description": "Emission intensity for aviation fuel (avgas). Well-to-Tank (WTT) fuels conversion factors should be used to account for the upstream Scope 3 emissions associated with extraction and refining and transportation of the raw fuel sources to an organisation’s site (or asset) - prior to combustion. Retrieved from the Conversion Factors 2021: flat file published by the UK BEIS/Defra at the source URL.",
"unit_type": [
"Weight"
],
"unit": "kg-CO2e/t",
"lca_activity": "upstream",
"supported_calculation_methods": [
"ar4"
],
"factor": 815.31014,
"factor_calculation_method": "ar4",
"factor_calculation_origin": "source",
"constituent_gases": {
"co2e_total": 815.31014,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{...},
{...}
]
}

Request models describe the different ways that emission factors can be selected in a query to the Climatiq API.

We collect, normalize, and organize emission factors by a variety of factors such as source, region, and year, allowing for granular selection of the relevant emission factors.

Emission factors can be selected by indicating a factor ID. If more than one emission factor exists with the same ID, the most recent year will be selected, followed by the most conservative (e.g. highest) if there is more than one available for the most recent year.

"emission_factor": "freight-goods-truck"

Emission factors can also be queried by specifying a set of attributes. If more than one emission factor exists with the same ID, the most recent year will be selected, followed by the most conservative (e.g. highest) if there is more than one available for the most recent year.

AttributeRequired
"emission_factor": {
"id": "freight-goods-truck",
"source": "MfE",
"region": "NZ",
"year": "2020"
}

Parameters are values passed into the API in order to produce emissions estimations. Click below to find out more about parameters for each unit type.

Unit
{
"parameters": {
"volume": 10,
"volume_unit": "l"
//...
}
}

Response models describe the different objects the Climatiq API might return

The estimation response model is returned in a variety of estimation-related endpoints.

The model contains the total amount of emissions in kgCO2e, and includes the emission factor used for the calculation.

Attribute
{
"co2e": 22.65504025,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"id": "heat-and-steam-type_purchased",
"source": "EPA",
"year": "2021",
"region": "US",
"category": "Heat and Steam",
"lca_activity": "unknown"
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 22.631796,
"ch4": 0.0004265,
"n2o": 0.00004265
}
}

The emission factor model gives you information about which emission factor Climatiq used to serve your query.

Attribute
"emission_factor": {
"id": "freight_flight-route_type_international-distance_long_haul-weight_na-contrails_included",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Air Transport",
"lca_activity": "usephase"
}

The constituent gases model explains which constituent gases the source of the data considers to be part of their calculations. Not all sources provide this data, so all the fields might be null.

The constituent gases also depend on the calculation methodology chosen. If you filter on different calculation methodologies, you might see different constituent gases. Learn more about calculation methods and constituent gases here

"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 22.631796,
"ch4": 0.0004265,
"n2o": 0.00004265
}

Unit types describe the categories of units available to be queried by the API for an emission factor. Each emission factor accepts a particular unit type, such as money or volume; any unit described for the unit type is acceptable, as the API will handle conversions.

Calculate emissions produced by a data amount, such as by transfer, expressed in megabytes (MB), gigabytes (GB) or Terabytes (TB).

{
//...
"parameters": {
"data": 3,
"data_unit": "GB"
}
//...
}

Calculate emissions produced by data over time, such as storing data for some duration.

{
//...
"parameters": {
"data": 3,
"data_unit": "GB",
"time": 1,
"time_unit": "h"
}
//...
}

Calculate emissions produced by moving a vehicle in kilometers, miles, nautical miles, meters or feet.

{
//...
"parameters": {
"distance": 100,
"distance_unit": "mi"
}
//...
}

Calculate emissions produced by consumption of energy in kWh, terajoules, gigajoules or MMBTU.

{
//...
"parameters": {
"energy": 30,
"energy_unit": "TJ"
}
//...
}

Calculate upstream emissions produced by purchase of goods or services, for example food, clothing or services, expressed in US Dollars, Euros or Pounds Sterling.

Where exchange rates are applied, these are calculated from IRS average exchange rates for the year of publication of the emission factor. Due to varying exchange rates and inflation, calculating emissions based on money spent is most accurate when the year for the emission factor is the same as the year you spent the money.

{
//...
"parameters": {
"money": 100,
"money_unit": "eur"
}
//...
}

This method works as a fallback for units without conversions like Hotel nights.

{
//...
"parameters": {
"number": 3
}
//...
}

Calculate emissions by a number in a given time expressed in days, hours, minutes, seconds or milliseconds. The numbers are multiplied together, so doubling the number or the time will yield the same results.

{
//...
"parameters": {
"number": 15,
"time": 3,
"time_unit": "m"
}
//...
}

Calculate emissions produced by moving a number of passengers over a given distance in kilometers, miles, nautical miles, meters or feet.

{
//...
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
}
//...
}

Calculate emissions in a given time expressed in days, hours, minutes, seconds or milliseconds.

{
//...
"parameters": {
"time": 3,
"time_unit": "m"
}
//...
}

Calculate emissions produced by volume of material consumed or utilised in a process or activity; for example diesel, expressed in litres, millilitres, cubic metres, standard cubic foot or US gallons.

{
//...
"parameters": {
"volume": 15,
"volume_unit": "l"
}
//...
}

Calculate emissions produced by total weight of material consumed, utilised or transported in a process or activity, expressed in kilograms, tonnes (metric tons) or US short tons.

{
//...
"parameters": {
"weight": 80,
"weight_unit": "t"
}
//...
}

Calculate emissions produced by moving goods of a certain weight (expressed in kilograms, tonnes (metric tons) or US short tons) over a distance (in kilometers, miles, nautical miles, meters or feet).

{
//...
"parameters": {
"weight": 80,
"weight_unit": "t",
"distance": 100,
"distance_unit": "mi"
}
//...
}

Learn how to perform estimations through examples.

Calculate emissions generated by electricity consumption.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "electricity-energy_source_coal_fired_plant",
"parameters": {
"energy": 30,
"energy_unit": "TJ"
}
}'

{
"co2e": 8833333.333404,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "electricity-energy_source_coal_fired_plant",
"source": "ADEME",
"year": "2021",
"region": "FR",
"category": "Electricity",
"lca_activity": "upstream-fuel_combustion"
},
"constituent_gases": {
"co2e_total": 8833333.333404,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by fuel consumption.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "fuel_type_asphalt_and_road_oil-fuel_use_stationary_combustion",
"parameters": {
"volume": 15,
"volume_unit": "l"
}
}'

{
"co2e": 47.34099231867451,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"id": "fuel_type_asphalt_and_road_oil-fuel_use_stationary_combustion",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Fuel",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 47.19433720365292,
"ch4": 0.0018624129710929365,
"n2o": 0.0003566322710603495
}
}

Calculate emissions generated by CPU utilization in cloud computing data centers, based on a given number of CPUs (number) running for a given time (time, time_unit).

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "cpu-provider_aws-region_af_south_1",
"parameters": {
"number": 15,
"time": 3,
"time_unit": "m"
}
}'

{
"co2e": 0.0016470675,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "cpu-provider_aws-region_af_south_1",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Cloud Computing - CPU",
"lca_activity": "use_phase"
},
"constituent_gases": {
"co2e_total": 0.0016470675,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by 1 hour of memory utilization in cloud computing data centers, based on a given amount of memory utilized (data, data_unit).

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "memory-provider_aws-region_af_south_1",
"parameters": {
"data": 15,
"data_unit": "GB",
"time": 3600,
"time_unit": "m"
}
}'

{
"co2e": 0.371601,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "memory-provider_aws-region_af_south_1",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Cloud Computing - Memory",
"lca_activity": "use_phase"
},
"constituent_gases": {
"co2e_total": 0.371601,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by 1 hour of data storage in cloud computing data centers, based on a given amount of data stored (data, data_unit).

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "sea_freight-vessel_type_bulk_carrier-route_type_na-vessel_length_na-tonnage_gt_100000dwt_lt_199999dwt-fuel_source_na",
"parameters": {
"data": 15,
"data_unit": "GB",
"time": 3600,
"time_unit": "m"
}
}'

{
"co2e": 0.0006161669999999999,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "storage-provider_aws-region_af_south_1-type_hdd",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Cloud Computing - Storage",
"lca_activity": "use_phase"
},
"constituent_gases": {
"co2e_total": 0.0006161669999999999,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by 1 hour of networking between cloud computing data centers, based on a given amount of data transmitted (data, data_unit).

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "networking-provider_aws-region_af_south_1",
"parameters": {
"data": 3,
"data_unit": "GB"
}
}'

{
"co2e": 0.0031598399999999997,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "networking-provider_aws-region_af_south_1",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Cloud Computing - Networking",
"lca_activity": "use_phase"
},
"constituent_gases": {
"co2e_total": 0.0031598399999999997,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by a hotel stay based on amount of nights.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "accommodation_type_holiday",
"parameters": {
"money": 120,
"money_unit": "eur"
}
}'

{
"co2e": 45.1061320754717,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "accommodation_type_holiday",
"source": "BEIS",
"year": "2018",
"region": "GB",
"category": "Accommodation",
"lca_activity": "unknown"
},
"constituent_gases": {
"co2e_total": 45.1061320754717,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by a vehicle travelling over a distance.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "commercial_vehicle-vehicle_type_hgv-fuel_source_bev-engine_size_na-vehicle_age_post_2015-vehicle_weight_gt_10t_lt_12t",
"parameters": {
"distance": 100,
"distance_unit": "mi"
}
}'

{
"co2e": 11.978012648448,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "commercial_vehicle-vehicle_type_hgv-fuel_source_bev-engine_size_na-vehicle_age_post_2015-vehicle_weight_gt_10t_lt_12t",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Vehicles",
"lca_activity": "electricity_consumption"
},
"constituent_gases": {
"co2e_total": 11.978012648448,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by water treatment.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "waste_type_hdpe-disposal_method_combusted",
"parameters": {
"volume": 15,
"volume_unit": "l"
}
}'

{
"co2e": 0.00408,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "water-treatment",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Water Treatment",
"lca_activity": "upstream"
},
"constituent_gases": {
"co2e_total": 0.00408,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by road travel.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "passenger_train-route_type_commuter_rail-fuel_source_na",
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
}
}'

{
"co2e": 131.425468416,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "passenger_vehicle-vehicle_type_black_cab-fuel_source_na-distance_na-engine_size_na",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Road Travel",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": 131.425468416,
"co2e_other": null,
"co2": 130.62079641600002,
"ch4": 0.001776715776,
"n2o": 0.804672
}
}

Calculate emissions generated by air travel.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "passenger_ferry-route_type_car_passenger-fuel_source_na",
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
}
}'

{
"co2e": 86.562184845312,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "passenger_flight-route_type_domestic-aircraft_type_jet-distance_na-class_na-rf_included",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Air Travel",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": 86.562184845312,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by rail travel.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "passenger_flight-route_type_domestic-aircraft_type_jet-distance_na-class_na-rf_included",
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
}
}'

{
"co2e": 56.022240000000004,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"id": "passenger_train-route_type_commuter_rail-fuel_source_na",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Rail Travel",
"lca_activity": "use_phase"
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 55.60000000000001,
"ch4": 0.00448,
"n2o": 0.00112
}
}

Calculate emissions generated by sea travel.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "paper_products-type_all_other_converted_paper_products",
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
}
}'

{
"co2e": 83.3749627392,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "passenger_ferry-route_type_car_passenger-fuel_source_na",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Sea Travel",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": 83.3749627392,
"co2e_other": null,
"co2": 82.2303972864,
"ch4": 0.024462028800000004,
"n2o": 1.120103424
}
}

Calculate emissions generated by transport of goods by road.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "freight_vehicle-vehicle_type-hgv_refrig-fuel_source_diesel-vehicle_weight_na-percentage_load_100",
"parameters": {
"weight": 7,
"weight_unit": "t",
"distance": 130,
"distance_unit": "km"
}
}'

{
"co2e": 78.61489999999999,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "freight_vehicle-vehicle_type-hgv_refrig-fuel_source_diesel-vehicle_weight_na-percentage_load_100",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Road Freight",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": 78.61489999999999,
"co2e_other": null,
"co2": 77.69579999999999,
"ch4": 0.0091,
"n2o": 0.91
}
}

Calculate emissions generated by transport of goods by air.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "freight_flight-route_type_domestic-distance_gt_1000km_lt_3500km-weight_gt_100t-rf_included",
"parameters": {
"weight": 7,
"weight_unit": "t",
"distance": 130,
"distance_unit": "km"
}
}'

{
"co2e": 1583.4,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "freight_flight-route_type_domestic-distance_gt_1000km_lt_3500km-weight_gt_100t-rf_included",
"source": "ADEME",
"year": "2021",
"region": "FR",
"category": "Air Freight",
"lca_activity": "fuel_upstream-fuel_combustion-fugitive_emissions"
},
"constituent_gases": {
"co2e_total": 1583.4,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by transport of goods by rail.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "freight_train-route_type_domestic-fuel_type_diesel",
"parameters": {
"weight": 7,
"weight_unit": "t",
"distance": 130,
"distance_unit": "km"
}
}'

{
"co2e": 30.94,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "freight_train-route_type_domestic-fuel_type_diesel",
"source": "UBA",
"year": "2020",
"region": "DE",
"category": "Rail Freight",
"lca_activity": "upstream-fuel_combustion"
},
"constituent_gases": {
"co2e_total": 30.94,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by transport of goods by sea.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "restaurants_accommodation-type_hotel_restaurant_services",
"parameters": {
"weight": 7,
"weight_unit": "t",
"distance": 130,
"distance_unit": "km"
}
}'

{
"co2e": 2.76822,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "sea_freight-vessel_type_bulk_carrier-route_type_na-vessel_length_na-tonnage_gt_100000dwt_lt_199999dwt-fuel_source_na",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Sea Freight",
"lca_activity": "fuel_combustion"
},
"constituent_gases": {
"co2e_total": 2.76822,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by construction waste.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "waste_management-type_food_waste_for_treatment_biogasification_land_application",
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 79.12,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "waste_type_aggregates-disposal_method_closed_loop",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Construction Waste",
"lca_activity": "end_of_life"
},
"constituent_gases": {
"co2e_total": 79.12,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by electrical waste.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "waste_type_aluminum_cans-disposal_method_combusted",
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 712.16,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "waste_type_batteries-disposal_method_landfill",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Electrical Waste",
"lca_activity": "gate_to_grave"
},
"constituent_gases": {
"co2e_total": 712.16,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by general waste.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "waste_type_beef-disposal_method_anaerobically_digested_dry_digestate_with_curing",
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 1703.52,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "waste_type_books-disposal_method_closed_loop",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "General Waste",
"lca_activity": "end_of_life"
},
"constituent_gases": {
"co2e_total": 1703.52,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by metal waste.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "waste_type_aggregates-disposal_method_closed_loop",
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 881.8490487395103,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "waste_type_aluminum_cans-disposal_method_combusted",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Metal Waste",
"lca_activity": "end_of_life"
},
"constituent_gases": {
"co2e_total": 881.8490487395103,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by paper and cardboard waste.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "waste_type_books-disposal_method_closed_loop",
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 1703.52,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "waste_type_cardboard-disposal_method_closed_loop",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Paper and Cardboard Waste",
"lca_activity": "end_of_life"
},
"constituent_gases": {
"co2e_total": 1703.52,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by plastic waste.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "waste_type_glass-disposal_method_combusted",
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 246917.73364706288,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "waste_type_hdpe-disposal_method_combusted",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Plastic Waste",
"lca_activity": "end_of_life"
},
"constituent_gases": {
"co2e_total": 246917.73364706288,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate upstream emissions produced by purchase of clothing.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": "consumer_goods-type_clothing",
"parameters": {
"money": 120,
"money_unit": "eur"
}
}'

{
"co2e": 266.40820980615734,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"id": "consumer_goods-type_clothing",
"source": "EPA",
"year": "2020",
"region": "US",
"category": "Clothing and Footwear",
"lca_activity": "cradle_to_shelf"
},
"constituent_gases": {
"co2e_total": 266.40820980615734,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}