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": {
"activity_id": "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.655980680727033,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"activity_id": "heat-and-steam-type_purchased",
"uuid": "da80d5f9-7fb2-4cd7-aa45-781479499845",
"id": "heat-and-steam-type_purchased",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Heat and Steam",
"lca_activity": "unknown",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 22.63273546583769,
"ch4": 0.0004265177043916345,
"n2o": 0.00004265177043916345
}
}

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": {
"activity_id": "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": {
"activity_id": "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": {
"activity_id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"uuid": "a41de667-978a-4a2a-942e-dc376d66ebcb",
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Vehicles",
"lca_activity": "use_phase",
"data_quality_flags": []
},
"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": {
"activity_id": "consumer_goods-type_snack_foods",
"uuid": "ea2618d1-f9b8-496a-a07b-b18288a8ced1",
"id": "consumer_goods-type_snack_foods",
"access_type": "public",
"source": "EPA",
"year": "2020",
"region": "US",
"category": "Food/Beverages/Tobacco",
"lca_activity": "cradle_to_shelf",
"data_quality_flags": []
},
"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": {
"activity_id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"uuid": "a41de667-978a-4a2a-942e-dc376d66ebcb",
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Vehicles",
"lca_activity": "use_phase",
"data_quality_flags": []
},
"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": 1366.6594004428948,
"co2e_unit": "kg",
"legs": [
{
"co2e": 116.75541111,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "passenger_flight-route_type_domestic-aircraft_type_na-distance_na-class_na-rf_na",
"uuid": "c165f89c-7ab9-4473-bfed-ff5ef99bab6f",
"id": "passenger_flight-route_type_domestic-aircraft_type_na-distance_na-class_na-rf_na",
"access_type": "public",
"source": "UBA",
"year": "2020",
"region": "DE",
"category": "Air Travel",
"lca_activity": "upstream-fuel_combustion",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 116.75541111,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 1249.9039893328948,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"activity_id": "passenger_flight-route_type_na-aircraft_type_na-distance_gt_2300mi-class_na-rf_na",
"uuid": "468e56b4-fe65-4a2f-9739-103f2fe58239",
"id": "passenger_flight-route_type_na-aircraft_type_na-distance_gt_2300mi-class_na-rf_na",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Air Travel",
"lca_activity": "use_phase",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 1239.2992373314842,
"ch4": 0.004561837683428775,
"n2o": 0.03953592658971606
}
}
]
}

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": 2623.9562904584072,
"co2e_unit": "kg",
"legs": [
{
"co2e": 163.073872325,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "freight_flight-route_type_domestic-distance_na-weight_na-rf_na",
"uuid": "f6a15edc-7cef-4f8e-8a6c-d9649e151851",
"id": "freight_flight-route_type_domestic-distance_na-weight_na-rf_na",
"access_type": "public",
"source": "UBA",
"year": "2020",
"region": "DE",
"category": "Air Freight",
"lca_activity": "upstream-fuel_combustion",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 163.073872325,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 2460.882418133407,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"activity_id": "freight_flight-route_type_na-distance_na-weight_na-rf_na",
"uuid": "a7862542-dabb-4721-8082-69f6a9517e6b",
"id": "freight_flight-route_type_na-distance_na-weight_na-rf_na",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Air Freight",
"lca_activity": "use_phase",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 2440.949394898755,
"ch4": 0,
"n2o": 0.07521895560245949
}
}
]
}

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. You can view the supported cloud providers by using the metadata endpoint

GET Returns metadata, such as what sort of providers and regions are available for the different computing endpoints.

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

The endpoint will return metadata for all cloud computing endpoints.

For each cloud provider an object is provided that consists of the following data.

{
"cloud_providers": {
"aws": {
"provider_full_name": "Amazon Web Services",
"provider_id": "aws",
"cpu_regions": [
"af_south_1",
"ap_east_1",
"ap_northeast_1"
// ...
],
"storage_regions": [
"af_south_1",
"ap_east_1"
// ...
],
"memory_regions": [
"af_south_1"
// ...
]
},
"azure": {
"provider_full_name": "Microsoft Azure",
"provider_id": "azure",
"cpu_regions": [
"central_india",
"central_us"
// ...
]
}
// More providers here
}
}

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 the id of the supported cloud providers. You can retrieve the different ids from the computing metadata endpoint

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 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": {
"activity_id": "cpu-provider_azure-region_uk_west",
"uuid": "be353893-f270-43a3-9d0f-82b2a6c8b46c",
"id": "cpu-provider_azure-region_uk_west",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "GB-CDF",
"category": "Cloud Computing - CPU",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.00057841,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

POST

Batch Estimations for CPU, allowing you to calculate multiple emission estimations in a single request. Currently limited to maximum 100 operations per request.

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

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

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

{
"results": [
{
"co2e": 0.00057841,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "cpu-provider_azure-region_uk_west",
"uuid": "be353893-f270-43a3-9d0f-82b2a6c8b46c",
"id": "cpu-provider_azure-region_uk_west",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "GB-CDF",
"category": "Cloud Computing - CPU",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.00057841,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 0.00043245,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "cpu-provider_azure-region_germany",
"uuid": "c502b010-25d5-4303-85fa-590976daae3c",
"id": "cpu-provider_azure-region_germany",
"access_type": "public",
"source": "CCF",
"year": "2022",
"region": "DE",
"category": "Cloud Computing - CPU",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.00043245,
"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 the id of the supported cloud providers. You can retrieve the different ids from the computing metadata endpoint

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

curl --request POST \
--url https://beta3.api.climatiq.io/compute/aws/storage \
--header 'Authorization: Bearer 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": {
"activity_id": "storage-provider_aws-region_af_south_1-type_ssd",
"uuid": "cb0636c2-d44b-4459-857a-3fc41b469e82",
"id": "storage-provider_aws-region_af_south_1-type_ssd",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Cloud Computing - Storage",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.0015167280000000004,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

POST

Batch Estimations for Storage, allowing you to calculate multiple emission estimations in a single request. Currently limited to maximum 100 operations per request.

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

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

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

{
"results": [
{
"co2e": 0.0015167280000000004,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "storage-provider_aws-region_af_south_1-type_ssd",
"uuid": "cb0636c2-d44b-4459-857a-3fc41b469e82",
"id": "storage-provider_aws-region_af_south_1-type_ssd",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Cloud Computing - Storage",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.0015167280000000004,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 0.0039715919999999995,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "storage-provider_aws-region_ap_east_1-type_ssd",
"uuid": "15b2e2a9-583c-476a-b1cd-c4726a2344b5",
"id": "storage-provider_aws-region_ap_east_1-type_ssd",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "HK-HKG",
"category": "Cloud Computing - Storage",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.0039715919999999995,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}
]
}

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 the id of the supported cloud providers. You can retrieve the different ids from the computing metadata endpoint

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 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": {
"activity_id": "memory-provider_gcp-region_us_west_2",
"uuid": "67193fb7-59ce-4fb3-8245-f559221900a4",
"id": "memory-provider_gcp-region_us_west_2",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "US-LAX",
"category": "Cloud Computing - Memory",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.02053248,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

POST

Batch Estimations for Memory, allowing you to calculate multiple emission estimations in a single request. Currently limited to maximum 100 operations per request.

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

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

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

{
"results": [
{
"co2e": 0.02053248,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "memory-provider_gcp-region_us_west_2",
"uuid": "67193fb7-59ce-4fb3-8245-f559221900a4",
"id": "memory-provider_gcp-region_us_west_2",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "US-LAX",
"category": "Cloud Computing - Memory",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.02053248,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
},
{
"co2e": 0.0193728,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "memory-provider_gcp-region_us_west_1",
"uuid": "fd361f5b-6103-44c3-8cbe-b9da01dc3b40",
"id": "memory-provider_gcp-region_us_west_1",
"access_type": "public",
"source": "CCF",
"year": "2021",
"region": "US-OR",
"category": "Cloud Computing - Memory",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.0193728,
"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:

curl --request POST \
--url https://beta3.api.climatiq.io/classifications/estimate \
--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": 46.61037,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "metal_products-type_fabricated_metal_products_except_machinery_equipment",
"uuid": "79e87731-dc29-470b-a2fa-73e30797bc53",
"id": "metal_products-type_fabricated_metal_products_except_machinery_equipment",
"access_type": "public",
"source": "EXIOBASE",
"year": "2021",
"region": "IN",
"category": "Fabricated Metal Products",
"lca_activity": "unknown",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 46.61037,
"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:

# 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": {
"activity_id": "accommodation_type_holiday",
"uuid": "5c37ee77-488d-4a21-83d7-7c06656eb0ff",
"id": "accommodation_type_holiday",
"access_type": "public",
"source": "BEIS",
"year": "2018",
"region": "GB",
"category": "Accommodation",
"lca_activity": "unknown",
"data_quality_flags": []
},
"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": {
"activity_id": "accommodation_type_holiday",
"uuid": "5c37ee77-488d-4a21-83d7-7c06656eb0ff",
"id": "accommodation_type_holiday",
"access_type": "public",
"source": "BEIS",
"year": "2018",
"region": "GB",
"category": "Accommodation",
"lca_activity": "unknown",
"data_quality_flags": []
},
"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": {
"activity_id": "consumer_goods-type_soft_drinks_bottled_water_ice",
"uuid": "85119a9d-087f-4f3a-94d5-702d99379964",
"id": "consumer_goods-type_soft_drinks_bottled_water_ice",
"access_type": "public",
"source": "EPA",
"year": "2020",
"region": "US",
"category": "Food/Beverages/Tobacco",
"lca_activity": "cradle_to_shelf",
"data_quality_flags": []
},
"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

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:

{
"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",
"uuid": "05d034db-dfe7-462e-9a19-a69ecd65a114",
"name": "Light-Duty Truck",
"category": "Vehicles",
"sector": "Transport",
"source": "EPA",
"source_link": "https://www.epa.gov/climateleadership/ghg-emission-factors-hub",
"uncertainty": null,
"year": "2021",
"region": "US",
"region_name": "United States",
"description": "Emission intensity of light duty truck (includes full-size pickup trucks/full-size vans/extended-length SUVs with wheelbase greater than 121 inches). Retrieved from the EPA's GHG Emission Factors Hub (xlsx).",
"unit_type": [
"Distance"
],
"unit": "kg/mile",
"lca_activity": "use_phase",
"data_quality_flags": [],
"supported_calculation_methods": [
"ar4",
"ar5"
],
"factor": 0.466986,
"factor_calculation_method": "ar5",
"factor_calculation_origin": "climatiq",
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 0.464,
"ch4": 0.000012,
"n2o": 0.00001
}
},
{...},
{...}
],
"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": [
"2022",
"2021",
"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",
"AIB",
"BEIS",
"CCF",
"DISER",
"EPA",
"EXIOBASE",
"GEMIS",
"GHG Protocol",
"UNFCCC"
]
}

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?source=MfE' \
--header 'Authorization: Bearer API_KEY'


Every region contains:

{
"results": [
{
"id": "NZ",
"name": "New Zealand"
},
{
"id": "NZ-WLG",
"name": "Wellington, WGN, NZ"
}
]
}

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 Freight",
"Air Travel",
"Building Materials",
"Clothing and Footwear",
"Construction Waste",
"Education",
"Electrical Equipment",
"Electrical Waste",
"Electricity",
"Electronics",
"Fabricated Metal Products",
"Financial Services",
"Food and Beverage Services",
"Food and Organic Waste",
"Food/Beverages/Tobacco",
"Fuel",
"Furnishings and Household",
"General Waste",
"Glass and Glass Products",
"Government Activities",
"Health Care",
"Heat and Steam",
"Homeworking",
"Housing",
"Information and Communication Services",
"Insurance Services",
"Metal Waste",
"Metals",
"Mined Materials",
"Non-profit Activities",
"Operational Activities",
"Organic Products",
"Paper and Cardboard",
"Paper and Cardboard Waste",
"Personal Care and Accessories",
"Plastic Waste",
"Plastics and Rubber Products",
"Professional services",
"Rail Freight",
"Rail Travel",
"Recreation and Culture",
"Refrigerants and Fugitive Gases",
"Road Freight",
"Road Travel",
"Sea Freight",
"Sea Travel",
"Social Care",
"Tickets and Passes",
"Timber and Forestry Products",
"Vehicle Maintenance and Services",
"Vehicles",
"Water Supply",
"Water Treatment"
]
}

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": [
"Agriculture/Hunting/Forestry/Fishing",
"Buildings and Infrastructure",
"Consumer Goods and Services",
"Education",
"Energy",
"Equipment",
"Health and Social Care",
"Information and Communication",
"Insurance and Financial Services",
"Materials and Manufacturing",
"Organizational Activities",
"Refrigerants and Fugitive Gases",
"Restaurants and Accommodation",
"Transport",
"Waste",
"Water"
]
}

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": [
"cradle_to_shelf",
"cradle_to_gate",
"electricity_generation",
"end_of_life",
"fuel_combustion",
"gate_to_grave",
"transmission_and_distribution",
"unknown",
"upstream",
"use_phase",
"well_to_tank"
]
}

GET Returns a list of unit types available for a given query.

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

The request parameters are the same as for Emission Query

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

{
"results": [
"Distance",
"Energy",
"Money",
"Number",
"PassengerOverDistance",
"Volume",
"Weight",
"WeightOverDistance",
"Time"
]
}

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 transferred. 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

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:

{
"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",
"data_quality_flags": [],
"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 queried by specifying a set of attributes. If more than one emission factor match the filtering criteria, the one from 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.

A selector for one specific emission factor, using the unique id for that emission factor can look like this:

"emission_factor": {
"uuid": "da80d5f9-7fb2-4cd7-aa45-781479499845",
}

A selector for one a specific activity, with additional filtering criteria can look like this:

"emission_factor": {
"activity_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.

{
"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.

{
"co2e": 22.655980680727033,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"activity_id": "heat-and-steam-type_purchased",
"uuid": "da80d5f9-7fb2-4cd7-aa45-781479499845",
"id": "heat-and-steam-type_purchased",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Heat and Steam",
"lca_activity": "unknown",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": null,
"co2e_other": null,
"co2": 22.63273546583769,
"ch4": 0.0004265177043916345,
"n2o": 0.00004265177043916345
}
}

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

"emission_factor": {
"activity_id": "heat-and-steam-type_purchased",
"uuid": "da80d5f9-7fb2-4cd7-aa45-781479499845",
"id": "heat-and-steam-type_purchased",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Heat and Steam",
"lca_activity": "unknown",
"data_quality_flags": []
},

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 an area, such as spraying fields, expressed in hectares (ha), square kilometers (km2), square meters (m2) or square foot (ft2).

{
//...
"parameters": {
"area": 30,
"area_unit": "ha"
}
//...
}

Calculate emissions produced by area over time.

{
//...
"parameters": {
"area": 30,
"area_unit": "ha",
"time": 365,
"time_unit": "day"
}
//...
}

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 distance over time, such as road maintenance.

{
//...
"parameters": {
"distance": 100,
"distance_unit": "mi"
"time": 365,
"time_unit": "days"
}
//...
}

Calculate emissions produced by consumption of energy in kWh, terajoules, gigajoules, megajoules 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 any of the supported currencies.

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 (average) years, 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"
}
//...
}

Calculate emissions produced by weight over time.

{
//...
"parameters": {
"weight": 80,
"weight_unit": "t",
"time": 20,
"time_unit": "days"
}
//...
}

Calculate emissions produced by moving goods inside a certain amount of twenty-foot-equivalent containers over a distance (in kilometers, miles, nautical miles, meters or feet).

{
//...
"parameters": {
"twenty_foot_equivalent": 2,
"distance": 100,
"distance_unit": "km"
}
//...
}

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": {
"activity_id": "electricity-energy_source_biogas_corn_chp"
},
"parameters": {
"energy": 30,
"energy_unit": "TJ"
}
}'

{
"co2e": 1500000.0000119999,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "electricity-energy_source_biogas_corn_chp",
"uuid": "f7bbf62a-fa7f-46c9-a3bd-1e4756637d73",
"id": "electricity-energy_source_biogas_corn_chp",
"access_type": "public",
"source": "GEMIS",
"year": "2021",
"region": "DE",
"category": "Electricity",
"lca_activity": "upstream-use_phase-transport",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 1500000.0000119999,
"co2e_other": null,
"co2": 450000.00000359997,
"ch4": 7583.333333394,
"n2o": 3083.333333358
}
}

Calculate emissions generated by fuel consumption.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": {
"activity_id": "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": {
"activity_id": "fuel_type_asphalt_and_road_oil-fuel_use_stationary_combustion",
"uuid": "787ccaa8-c856-4741-8229-8a35b76dc03e",
"id": "fuel_type_asphalt_and_road_oil-fuel_use_stationary_combustion",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Fuel",
"lca_activity": "fuel_combustion",
"data_quality_flags": []
},
"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": {
"activity_id": "cpu-provider_aws-region_af_south_1"
},
"parameters": {
"number": 15,
"time": 3,
"time_unit": "m"
}
}'

{
"co2e": 0.00162525,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "cpu-provider_aws-region_af_south_1",
"uuid": "83adc178-f188-4213-92cb-07ff4075a3f8",
"id": "cpu-provider_aws-region_af_south_1",
"access_type": "public",
"source": "CCF",
"year": "2022",
"region": "ZA-CPT",
"category": "Cloud Computing - CPU",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.00162525,
"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": {
"activity_id": "memory-provider_aws-region_af_south_1"
},
"parameters": {
"data": 15,
"data_unit": "GB",
"time": 3600,
"time_unit": "m"
}
}'

{
"co2e": 0.36063,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "memory-provider_aws-region_af_south_1",
"uuid": "e2a56cb6-894a-48a8-a1fc-d5ab68641629",
"id": "memory-provider_aws-region_af_south_1",
"access_type": "public",
"source": "CCF",
"year": "2022",
"region": "ZA-CPT",
"category": "Cloud Computing - Memory",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.36063,
"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": {
"activity_id": "storage-provider_aws-region_af_south_1-type_hdd"
},
"parameters": {
"data": 15,
"data_unit": "GB",
"time": 3600,
"time_unit": "m"
}
}'

{
"co2e": 0.0005979599999999999,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "storage-provider_aws-region_af_south_1-type_hdd",
"uuid": "64055f56-93e0-4144-a0b0-d82fbc93d79c",
"id": "storage-provider_aws-region_af_south_1-type_hdd",
"access_type": "public",
"source": "CCF",
"year": "2022",
"region": "ZA-CPT",
"category": "Cloud Computing - Storage",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.0005979599999999999,
"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": {
"activity_id": "networking-provider_aws-region_af_south_1"
},
"parameters": {
"data": 3,
"data_unit": "GB"
}
}'

{
"co2e": 0.0030666,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "networking-provider_aws-region_af_south_1",
"uuid": "249193d6-775b-482c-b80c-a75618397495",
"id": "networking-provider_aws-region_af_south_1",
"access_type": "public",
"source": "CCF",
"year": "2022",
"region": "ZA-CPT",
"category": "Cloud Computing - Networking",
"lca_activity": "use_phase",
"data_quality_flags": [
"notable_methodological_variance"
]
},
"constituent_gases": {
"co2e_total": 0.0030666,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}

Calculate emissions generated by a hotel stay based on number of people- or room-nights.

curl --request POST \
--url 'https://beta3.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": {
"activity_id": "accommodation_type_hotel_room"
},
"parameters": {
"number": 3
}
}'

{
"co2e": 53.94,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "accommodation_type_hotel_room",
"uuid": "3c4f6a14-35a9-483a-b613-dec3098ac088",
"id": "accommodation_type_hotel_room",
"access_type": "public",
"source": "GHG Protocol",
"year": "2017",
"region": "GLOBAL",
"category": "Accommodation",
"lca_activity": "unknown",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 53.94,
"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": {
"activity_id": "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": {
"activity_id": "commercial_vehicle-vehicle_type_hgv-fuel_source_bev-engine_size_na-vehicle_age_post_2015-vehicle_weight_gt_10t_lt_12t",
"uuid": "ad61b8d9-bf2f-4689-b846-f9b829789f23",
"id": "commercial_vehicle-vehicle_type_hgv-fuel_source_bev-engine_size_na-vehicle_age_post_2015-vehicle_weight_gt_10t_lt_12t",
"access_type": "public",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Vehicles",
"lca_activity": "electricity_consumption",
"data_quality_flags": []
},
"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": {
"activity_id": "water-treatment"
},
"parameters": {
"volume": 15,
"volume_unit": "l"
}
}'

{
"co2e": 0.00408,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "water-treatment",
"uuid": "479a725c-3ee5-4bc7-ac03-6917fa6549aa",
"id": "water-treatment",
"access_type": "public",
"source": "BEIS",
"year": "2022",
"region": "GB",
"category": "Water Treatment",
"lca_activity": "upstream",
"data_quality_flags": []
},
"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": {
"activity_id": "passenger_vehicle-vehicle_type_black_cab-fuel_source_na-distance_na-engine_size_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": {
"activity_id": "passenger_vehicle-vehicle_type_black_cab-fuel_source_na-distance_na-engine_size_na",
"uuid": "ba32f6f2-9ec2-42eb-8ced-cd9d17a4491d",
"id": "passenger_vehicle-vehicle_type_black_cab-fuel_source_na-distance_na-engine_size_na",
"access_type": "public",
"source": "BEIS",
"year": "2022",
"region": "GB",
"category": "Road Travel",
"lca_activity": "fuel_combustion",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 131.425468416,
"co2e_other": null,
"co2": 130.62079641600002,
"ch4": 0.000077248512,
"n2o": 0.002697260544
}
}

Calculate emissions generated by air travel.

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

{
"co2e": 86.562184845312,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "passenger_flight-route_type_domestic-aircraft_type_jet-distance_na-class_na-rf_included",
"uuid": "bb4af0d9-ab8e-47bd-ae59-543deb21700e",
"id": "passenger_flight-route_type_domestic-aircraft_type_jet-distance_na-class_na-rf_included",
"access_type": "public",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Air Travel",
"lca_activity": "fuel_combustion",
"data_quality_flags": []
},
"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": {
"activity_id": "passenger_train-route_type_commuter_rail-fuel_source_na"
},
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
}
}'

{
"co2e": 56.022240000000004,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "climatiq",
"emission_factor": {
"activity_id": "passenger_train-route_type_commuter_rail-fuel_source_na",
"uuid": "ecb058be-cc15-450e-8572-8aaabb83cd5e",
"id": "passenger_train-route_type_commuter_rail-fuel_source_na",
"access_type": "public",
"source": "EPA",
"year": "2022",
"region": "US",
"category": "Rail Travel",
"lca_activity": "use_phase",
"data_quality_flags": []
},
"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": {
"activity_id": "passenger_ferry-route_type_car_passenger-fuel_source_na"
},
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
}
}'

{
"co2e": 83.376893952,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "passenger_ferry-route_type_car_passenger-fuel_source_na",
"uuid": "92a8d0ea-31f1-4855-b148-c2af00b7a4c5",
"id": "passenger_ferry-route_type_car_passenger-fuel_source_na",
"access_type": "public",
"source": "BEIS",
"year": "2022",
"region": "GB",
"category": "Sea Travel",
"lca_activity": "fuel_combustion",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 83.376893952,
"co2e_other": null,
"co2": 82.231041024,
"ch4": 0.00102998016,
"n2o": 0.0037594275840000003
}
}

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": {
"activity_id": "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.6422,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "freight_vehicle-vehicle_type-hgv_refrig-fuel_source_diesel-vehicle_weight_na-percentage_load_100",
"uuid": "87f4458d-cf15-468a-82dc-579b1b5418fe",
"id": "freight_vehicle-vehicle_type-hgv_refrig-fuel_source_diesel-vehicle_weight_na-percentage_load_100",
"access_type": "public",
"source": "BEIS",
"year": "2022",
"region": "GB",
"category": "Road Freight",
"lca_activity": "fuel_combustion",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 78.6422,
"co2e_other": null,
"co2": 77.7231,
"ch4": 0.00036399999999999996,
"n2o": 0.0030576
}
}

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": {
"activity_id": "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": {
"activity_id": "freight_flight-route_type_domestic-distance_gt_1000km_lt_3500km-weight_gt_100t-rf_included",
"uuid": "bec9304f-21ef-42f7-9982-dae461f2b8b8",
"id": "freight_flight-route_type_domestic-distance_gt_1000km_lt_3500km-weight_gt_100t-rf_included",
"access_type": "public",
"source": "ADEME",
"year": "2021",
"region": "FR",
"category": "Air Freight",
"lca_activity": "fuel_upstream-fuel_combustion-fugitive_emissions",
"data_quality_flags": []
},
"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": {
"activity_id": "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": {
"activity_id": "freight_train-route_type_domestic-fuel_type_diesel",
"uuid": "549e5723-ba27-4fe6-9cbd-9d46965b08f2",
"id": "freight_train-route_type_domestic-fuel_type_diesel",
"access_type": "public",
"source": "UBA",
"year": "2020",
"region": "DE",
"category": "Rail Freight",
"lca_activity": "upstream-fuel_combustion",
"data_quality_flags": []
},
"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": {
"activity_id": "sea_freight-vessel_type_bulk_carrier-route_type_na-vessel_length_na-tonnage_gt_100000dwt_lt_199999dwt-fuel_source_na"
},
"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": {
"activity_id": "sea_freight-vessel_type_bulk_carrier-route_type_na-vessel_length_na-tonnage_gt_100000dwt_lt_199999dwt-fuel_source_na",
"uuid": "009054a1-6e08-4d62-b943-2fa9322b0e9d",
"id": "sea_freight-vessel_type_bulk_carrier-route_type_na-vessel_length_na-tonnage_gt_100000dwt_lt_199999dwt-fuel_source_na",
"access_type": "public",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Sea Freight",
"lca_activity": "fuel_combustion",
"data_quality_flags": []
},
"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": {
"activity_id": "waste_type_aggregates-disposal_method_closed_loop"
},
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 78.7768,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "waste_type_aggregates-disposal_method_closed_loop",
"uuid": "1bdcafba-3ca2-4615-ab84-ef7a6e9bd485",
"id": "waste_type_aggregates-disposal_method_closed_loop",
"access_type": "public",
"source": "BEIS",
"year": "2022",
"region": "GB",
"category": "Construction Waste",
"lca_activity": "end_of_life",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 78.7768,
"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": {
"activity_id": "waste_type_batteries-disposal_method_landfill"
},
"parameters": {
"weight": 80,
"weight_unit": "t"
}
}'

{
"co2e": 710.6615999999999,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "waste_type_batteries-disposal_method_landfill",
"uuid": "921b6792-5c9d-4754-931e-df4aae441633",
"id": "waste_type_batteries-disposal_method_landfill",
"access_type": "public",
"source": "BEIS",
"year": "2022",
"region": "GB",
"category": "Electrical Waste",
"lca_activity": "gate_to_grave",
"data_quality_flags": []
},
"constituent_gases": {
"co2e_total": 710.6615999999999,
"co2e_other": null,
"co2": null,
"ch4": null,
"n2o": null
}
}