API Reference

Introduction

Climatiq helps you capture the environmental footprint created by a broad range of business activities.

We simplify the process of collecting and converting your operational data into CO2e (carbon dioxide equivalent) estimates, allowing you to spend more time analyzing your activities and taking actions to manage and reduce your environmental impact.

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

Using the Climatiq REST API, you can collect data from your software and systems, and automatically transform that data into CO2e values, using verified scientific data and methodologies.

Getting Started

The Climatiq API is designed to help developers build tools to automate reductions in their organizations' carbon footprint.

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.

Base URL

https://beta.api.climatiq.io

Select Emission Factor

An emission factor is a value that relates the quantity of a pollutant released to the atmosphere with a particular activity.

For example:

  • grid-mix: Energy consumed using grid electricity, measured in kWh.
  • flight-domestic: Domestic airplane flight, calculated using distance or airport codes.
  • articulated-truck: Transportation with an articulated truck, measured using weight and distance.

Authentication

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.

Content-Type

To send data to our API, send the content-type header to application/json.

Content-Type: application/json

Errors

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

Status Codes

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.

Emission Factors

GET List all available emission factors—or query with parameters such category, source, region, or year—to help determine what emission factor should be used in your estimation.

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

Request

AttributeTypeDescription
sectorstringFilters by emission factor sector. Defaults to alloptional
categorystringFilters by emission factor category. Defaults to alloptional
sourcestringFilters emission factors by data sourceoptional
regionstringFilters emission factors by region. Defaults to alloptional
yearstringFilters emission factors by year. Defaults to alloptional

Response

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

[
{
"id": "string",
"name": "string",
"category": "string",
"sector": "string",
"source": "string",
"source_link": "string",
"uncertainty": "number",
"year": "string",
"region": "string",
"region_name": "string",
"description": "string"
}
]

Estimate

POST Calculate estimated emissions in KgCO2 for a particular activity using the available emission factors. All requests are performed sending a POST request to the following endpoint:

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

You will find more specific examples for the following categories below: Electricity, Vehicle, Travel, Transport, Fuel, Water, Waste, and Accommodation.

Request

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

AttributeTypeDescription
emission_factorSelectorEmission Factor ID or selection parameters. See below for more details.required
parametersParametersEmission factor parameters. See below for more details.required
persistbooleanPersist the estimate to the Analytics Dashboard. Default is true.optional
metadataMetadataProvide optional metadata when persisting the estimate. See below for more details.optional

Emission Factor Selection

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

If no particular methodology is selected, the most conservative one will be automatically selected, representing the highest emitting emission factor.

"emission_factor": "string"
// or
"emission_factor": {
"id": "string",
"source": "string",
"region": "string",
"year": "string"
}

Parameters

Every emission factor category can accept different parameters. Check emission factors by sector for more details.

"parameters": {
"distance": "number",
"weight": "number",
"amount": "number"
}

Persistence

On every request, estimations can be persisted or volatile, depending on the value of the persist parameter.

true (default): emission estimates are stored in our analytics database and used for emission tracking, reporting, and other features.

false: emission estimates are not stored. This calculation can be used for displaying the resulting emission or stored in your own data storage.

"persist": boolean,

Metadata

While metadata is automatically calculated where possible, it can be overwritten with custom values. Currently only category will be populated while tags and scope will be empty unless a value is provided.

"metadata": {
"scope": "1" | "2" | "3",
"category": "string",
"tags": "string[]",
}

Metadata Parameters

AttributeTypeDescription
scopestringEmission scope according to the GHG Protocol. Possible values are "1", "2," and "3". Default is unknown.optional
categorystringEmission category. Default is the emission factor category.optional

Estimation Request Body Types

{
"emission_factor": "string" | {
"id": "string",
"source": "string",
"region": "string",
"year": "string"
},
"parameters": {
"distance": number,
"weight": number
},
"persist": boolean,
"metadata": {
"scope": "1" | "2" | "3",
"category": "string",
"tags": "string[]",
}
}

Response Types

The response includes the selected emission factor and the total amount of emissions in kgCO2e.

{
"co2e": number,
"id": "string",
"source": "string",
"year": "string",
"region": "string",
"category": "string",
"value": number
}

Electricity

Calculate emissions generated by electricity consumption.

Parameters

AttributeTypeDescriptionRequiredDefault
amountnumberTotal amount of energy consumed in the defined unit.Yes
amount_unitstringUnit of Energy. Supported values: kWh, GJ and TJNokWh

Electricity Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "grid-mix",
"parameters": {
"amount": 100
}
}'

Electricity Emission Factors

Name
ID
Source
Region
Year
Description
Coal Power Plantcoal-steam-turbine-power-plant
DEGermany
2020

Öko-Institut / IINAS - International Institute for Sustainability Analysis

Coal Steam Turbine Power Plant Final Energy 100%coal-steam-turbine-power-plant-final-energy-100
DEGermany
2020

Öko-Institut / IINAS - International Institute for Sustainability Analysis

Coal Steam Turbine Power Plant German Importcoal-steam-turbine-power-plant-german-import
DEGermany
2020

Öko-Institut / IINAS - International Institute for Sustainability Analysis

Coal Steam Turbine Power Plant German-Import Final Energy 100%coal-steam-turbine-power-plant-german-import-final-energy-100
DEGermany
2020

Öko-Institut / IINAS - International Institute for Sustainability Analysis

Grid Coalgrid-coal
ADEMELink
FRFrance
2018

Emission Intensity for Average Coal Power Station Production. Continental France. Updated December 2018. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie.

Grid Fuel Oilgrid-fuel-oil
ADEMELink
FRFrance
2018

Emission Intensity for Average Fuel Oil Station Production. Continental France. Updated December 2018. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie.

Grid Gasgrid-gas
ADEMELink
FRFrance
2018

Emission Intensity for Average Gas Station Production. Continental France. Updated December 2018. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie.

Grid Geothermalgrid-geothermal
ADEMELink
FRFrance
2016

Emission Intensity for Geothermal Production. Continental France. Updated 2016. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie.

Grid Mixgrid-mix
ADEMELink
KWKuwait
2014

Emission Intensity of Grid Mix. Kuwait. Updated 2014. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Manufactured in France. Provided by the IEA.

Grid Mixgrid-mix
ADEMELink
SESweden
2014

Emission Intensity of Grid Mix. Sweden. Updated 2014. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Manufactured in France. Provided by the IEA.

Fuel

Calculate emissions generated by fuel consumption.

Parameters

AttributeTypeDescriptionRequiredDefault
amountnumberTotal amount of fuel consumed in the defined unit.Yes
amount_unitstringUnit of volume. Supported values: ML, L and m3NoL

Fuel Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "butane",
"parameters": {
"amount": 100
}
}'

Fuel Emission Factors

Name
ID
Source
Region
Year
Description
Aviation fuel (Kerosene)aviation-fuel-kerosene
NZNew Zealand
2020

Emission Intensity of Aviation fuel (Kerosene). Estimated in kg-CO2e/l. Transport fuel emission factors. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Aviation gasaviation-gas
NZNew Zealand
2020

Emission Intensity of Aviation gas. Estimated in kg-CO2e/l. Transport fuel emission factors. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Aviation Spiritaviation-spirit
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Aviation Spirit. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Aviation Turbine Oilaviation-turbine-oil
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Aviation Turbine Oil. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Biodieselbiodiesel
NZNew Zealand
2020

Emission Intensity of Biodiesel. Estimated in kg-CO2e/l. Biofuel and biomass emission factors. Biofuel. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Biodiesel HVObiodiesel-hvo
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Biodiesel HVO. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Biodiesel MEbiodiesel-me
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Biodiesel ME. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Biodiesel ME (from Tallow)biodiesel-me-tallow
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Biodiesel ME (from tallow). Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Biodiesel ME (From Used Cooking Oil)biodiesel-me-used-cooking-oil
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Biodiesel ME (from used cooking oil). Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Bioethanolbioethanol
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Bioethanol. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

CPU

Calculate emissions generated CPU usage in Cloud Computing.

Parameters

AttributeTypeDescriptionRequired
amountnumberTotal amount of CPUs per hour.Yes

CPU Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "aws-ap-northeast-1-cpu",
"parameters": {
"amount": 10
}
}'

CPU Emission Factors

Name
ID
Source
Region
Year
Description
AWS (AF SOUTH 1) CPUaws-af-south-1-cpu
ZA-CPTCape Town, WC, ZA
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP EAST 1) CPUaws-ap-east-1-cpu
HK-HKGHong Kong, HK
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 1) CPUaws-ap-northeast-1-cpu
JP-TYOTokyo, 13, JP
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 2) CPUaws-ap-northeast-2-cpu
KR-SELSeoul, 11, KR
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 3) CPUaws-ap-northeast-3-cpu
JP-OSAOsaka, 27, JP
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTH 1) CPUaws-ap-south-1-cpu
IN-BOMMumbai (ex Bombay), MH, IN
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTHEAST 1) CPUaws-ap-southeast-1-cpu
SG-SINSingapore, SG
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTHEAST 2) CPUaws-ap-southeast-2-cpu
AU-SYDSydney, NSW, AU
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (CA CENTRAL 1) CPUaws-ca-central-1-cpu
CA-MTRMontreal, QC, CA
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (CN NORTH 1) CPUaws-cn-north-1-cpu
CN-BJSBeijing, BJ, CN
2021

Emission Intensity for 1 CPU in kg CO2e per hour for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

Memory

Calculate emissions generated memory usage in Cloud Computing.

Parameters

AttributeTypeDescriptionRequiredDefault
amountnumberTotal amount of memory used the defined unit.Yes
amount_unitstringUnit of storage. Supported values: MB, GB and TBNoMB

Memory Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "aws-ap-northeast-1-memory",
"parameters": {
"amount": 10
}
}'

Memory Emission Factors

Name
ID
Source
Region
Year
Description
AWS (AF SOUTH 1) MEMORYaws-af-south-1-memory
ZA-CPTCape Town, WC, ZA
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP EAST 1) MEMORYaws-ap-east-1-memory
HK-HKGHong Kong, HK
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 1) MEMORYaws-ap-northeast-1-memory
JP-TYOTokyo, 13, JP
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 2) MEMORYaws-ap-northeast-2-memory
KR-SELSeoul, 11, KR
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 3) MEMORYaws-ap-northeast-3-memory
JP-OSAOsaka, 27, JP
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTH 1) MEMORYaws-ap-south-1-memory
IN-BOMMumbai (ex Bombay), MH, IN
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTHEAST 1) MEMORYaws-ap-southeast-1-memory
SG-SINSingapore, SG
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTHEAST 2) MEMORYaws-ap-southeast-2-memory
AU-SYDSydney, NSW, AU
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (CA CENTRAL 1) MEMORYaws-ca-central-1-memory
CA-MTRMontreal, QC, CA
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (CN NORTH 1) MEMORYaws-cn-north-1-memory
CN-BJSBeijing, BJ, CN
2021

Emission Intensity for the memory in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

Storage

Calculate emissions generated in Cloud Storage.

Parameters

AttributeTypeDescriptionRequiredDefalt
amountnumberTotal amount of storage used in the defined unit.Yes
amount_unitstringUnit of storage. Supported values: MB, GB and TBNoMB

Storage Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "aws-ap-northeast-1-ssd-storage",
"parameters": {
"amount": 10
}
}'

Storage Emission Factors

Name
ID
Source
Region
Year
Description
AWS (AF SOUTH 1) HDD STORAGEaws-af-south-1-hdd-storage
ZA-CPTCape Town, WC, ZA
2021

Emission Intensity for the HDD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AF SOUTH 1) SSD STORAGEaws-af-south-1-ssd-storage
ZA-CPTCape Town, WC, ZA
2021

Emission Intensity for the SSD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP EAST 1) HDD STORAGEaws-ap-east-1-hdd-storage
HK-HKGHong Kong, HK
2021

Emission Intensity for the HDD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP EAST 1) SSD STORAGEaws-ap-east-1-ssd-storage
HK-HKGHong Kong, HK
2021

Emission Intensity for the SSD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 1) HDD STORAGEaws-ap-northeast-1-hdd-storage
JP-TYOTokyo, 13, JP
2021

Emission Intensity for the HDD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 1) SSD STORAGEaws-ap-northeast-1-ssd-storage
JP-TYOTokyo, 13, JP
2021

Emission Intensity for the SSD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 2) HDD STORAGEaws-ap-northeast-2-hdd-storage
KR-SELSeoul, 11, KR
2021

Emission Intensity for the HDD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 2) SSD STORAGEaws-ap-northeast-2-ssd-storage
KR-SELSeoul, 11, KR
2021

Emission Intensity for the SSD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 3) HDD STORAGEaws-ap-northeast-3-hdd-storage
JP-OSAOsaka, 27, JP
2021

Emission Intensity for the HDD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 3) SSD STORAGEaws-ap-northeast-3-ssd-storage
JP-OSAOsaka, 27, JP
2021

Emission Intensity for the SSD storage in kg CO2e per terabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

Networking

Calculate emissions generated in Networking Traffic.

Parameters

AttributeTypeDescriptionRequiredDefault
amountnumberTotal amount of traffic tansferred in the defined unit.Yes
amount_unitstringUnit of storage. Supported values: MB, GB and TBNoMB

Networking Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "aws-ap-northeast-1-networking",
"parameters": {
"amount": 100
}
}'

Networking Emission Factors

Name
ID
Source
Region
Year
Description
AWS (AF SOUTH 1) NETWORKINGaws-af-south-1-networking
ZA-CPTCape Town, WC, ZA
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP EAST 1) NETWORKINGaws-ap-east-1-networking
HK-HKGHong Kong, HK
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 1) NETWORKINGaws-ap-northeast-1-networking
JP-TYOTokyo, 13, JP
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 2) NETWORKINGaws-ap-northeast-2-networking
KR-SELSeoul, 11, KR
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP NORTHEAST 3) NETWORKINGaws-ap-northeast-3-networking
JP-OSAOsaka, 27, JP
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTH 1) NETWORKINGaws-ap-south-1-networking
IN-BOMMumbai (ex Bombay), MH, IN
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTHEAST 1) NETWORKINGaws-ap-southeast-1-networking
SG-SINSingapore, SG
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (AP SOUTHEAST 2) NETWORKINGaws-ap-southeast-2-networking
AU-SYDSydney, NSW, AU
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (CA CENTRAL 1) NETWORKINGaws-ca-central-1-networking
CA-MTRMontreal, QC, CA
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

AWS (CN NORTH 1) NETWORKINGaws-cn-north-1-networking
CN-BJSBeijing, BJ, CN
2021

Emission Intensity for the networking in kg CO2e per gigabyte for the AWS data centers in the given location. Using the assumptions and grid mix data available in the source.

Accomodation

Calculate emissions generated by a hotel stay.

Parameters

AttributeTypeDescription
amountnumberAmount of nights per guest.required

Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "hotel-night",
"parameters": {
"amount": 7
}
}'

Accomodation Emission Factors

Name
ID
Source
Region
Year
Description
Hotel Nighthotel-night
DEFRALink
ATAustria
2021

Emission Intensity in kg CO2e of Average Hotel Night in Austria. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
TWTaiwan, Province of China
2021

Emission Intensity in kg CO2e of Average Hotel Night in Taiwan, China. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
PAPanama
2021

Emission Intensity in kg CO2e of Average Hotel Night in Panama. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
PEPeru
2021

Emission Intensity in kg CO2e of Average Hotel Night in Peru. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
THThailand
2021

Emission Intensity in kg CO2e of Average Hotel Night in Thailand. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
JPJapan
2021

Emission Intensity in kg CO2e of Average Hotel Night in Japan. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
AUAustralia
2021

Emission Intensity in kg CO2e of Average Hotel Night in Australia. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
RORomania
2021

Emission Intensity in kg CO2e of Average Hotel Night in Romania. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
RURussian Federation
2021

Emission Intensity in kg CO2e of Average Hotel Night in the Russian Federation. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Hotel Nighthotel-night
DEFRALink
SKSlovakia
2021

Emission Intensity in kg CO2e of Average Hotel Night in the Slovak Republic. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Vehicle

Calculate emissions generated by a vehicle over a distance.

Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
routestring[]List of locations as ZIP codes.planned

Vehicle Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "small-petrol-car",
"parameters": {
"distance": 100
}
}'

Vehicle Emission Factors

Name
ID
Source
Region
Year
Description
Average Carcar
ADEMELink
FRFrance
2018

Emission Intensity of Average Car. Average Motorisation Level. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Car Battery EVcar-battery-ev
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Electricity for Average Car Battery Electric Vehicle. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Average Car Hybrid EVcar-hybrid-ev
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Electricity for of Average Car Hybrid Electric Vehicle. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Average CNG Carcng-car
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Average CNG Car. A compressed version of the same natural gas you receive in the home. 2.0-litre engine +. When compressed can be used as an alternative vehicle fuel. Unknown Engine Size. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Average CNG Carcng-car
ADEMELink
FRFrance
2018

Emission Intensity of Average CNG Car. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Diesel Cardiesel-car
ADEMELink
FRFrance
2018

Emission Intensity of Average Diesel Car. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Diesel Cardiesel-car
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Average Diesel Car. Unknown Engine Size. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Average E85 Care85-car
ADEMELink
FRFrance
2018

Emission Intensity of Average E85 Car. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Hybrid Carhybrid-car
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Average Hybrid Car. A vehicle with two power sources, typically petrol and electric. Unknown Engine Size. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Average LPG Carlpg-car
ADEMELink
FRFrance
2018

Emission Intensity of Average LPG Car. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Road Travel

Calculate emissions generated by road travel.

Road Travel Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
routestring[]List of locations as ZIP codes.planned

Road Travel Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "local-bus",
"parameters": {
"distance": 100
}
}'

Road Travel Emission Factors

Name
ID
Source
Region
Year
Description
Average Car Short Distancecar-short-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average Car. Short Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Busaverage-bus
NZNew Zealand
2020

Emission Intensity of Average Bus. Provided by the Ministry for the Environment. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Average Car Long Distancecar-long-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average Car. Average Motorisation Level. Long Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Car Mixed Distancecar-mixed-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average Car. Average Motorisation Level. Mixed Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average CNG Car Long Distancecng-car-long-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average CNG Car. Mixed Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average CNG Car Mixed Distancecng-car-mixed-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average CNG Car. Long Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average CNG Car Short Distancecng-car-short-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average CNG Car. Short Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Diesel Car Long Distancediesel-car-long-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average Petrol Car. Long Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Diesel Car Mixed Distancediesel-car-mixed-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average Petrol Car. Mixed Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Average Diesel Car Short Distancediesel-car-short-distance
ADEMELink
FRFrance
2018

Emission Intensity of Average Petrol Car. Short Distance. Continental France. 2018 Factor. Updated April 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the HBEFA & Yearly Compte des Transports.

Air Travel

Calculate emissions generated by air travel.

Air Travel Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
routestring[]List of IATA airport codes.No

Air Travel Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "domestic-flight",
"parameters": {
"distance": 300
}
}'

Air Travel Emission Factors

Name
ID
Source
Region
Year
Description
Air Travel Short Haulair-travel-short-haul
USUnited States
2021

Emission Intensity of Air Travel. Short Haul (< 300 miles). Published by the EPA. Updated April 2021.

Domestic Flightdomestic-flight
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Domestic Flight to/from UK. Average passenger. Domestic flights are those between UK airports. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Domestic Flight Jet Aircraftdomestic-flight-jet-aircraft
NZNew Zealand
2020

Emission intensity of Domestic Flight. Jet Aircraft. With Radiative Force. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Domestic Flight Medium Aircraftdomestic-flight-medium-aircraft
NZNew Zealand
2020

Emission intensity of Domestic Flight. Medium Aircraft. With Radiative Force. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Domestic Flight National Averagedomestic-flight-national-average
NZNew Zealand
2020

Emission intensity of Domestic Flight. National Average. With Radiative Force. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Domestic Flight Small Aircraftdomestic-flight-small-aircraft
NZNew Zealand
2020

Emission intensity of Domestic Flight. Small Aircraft. With Radiative Force. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

International Flightinternational-flight
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of International Flight to/from non-UK Average Passenger. International flights to/from non-UK countries. First Class. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

International Flight Businessinternational-flight-business
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of International Flight to/from non-UK. Business Class. International flights to/from non-UK countries. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

International Flight Economyinternational-flight-economy
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of International Flight to/from non-UK. Economy Class. International flights to/from non-UK countries. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

International Flight First Classinternational-flight-first-class
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of International Flight to/from non-UK. First Class. First Class. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Rail Travel

Calculate emissions generated by rail travel.

Rail Travel Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
routestring[]List location ids.planned

Rail Travel Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "train",
"parameters": {
"distance": 20
}
}'

Rail Travel Emission Factors

Name
ID
Source
Region
Year
Description
Commuter Railcommuter-rail
USUnited States
2021

Emission Intensity of Commuter Rail. Commuter rail: rail service between a central city and adjacent suburbs (also called regional rail or suburban rail). Published by the EPA. Updated April 2021.

Intercity Rail National Averageintercity-rail-national
USUnited States
2020

Emission Intensity of Intercity Rail National Average. Intercity rail: Amtrak long-distance rail between major cities. Northeast Corridor extends from Boston to Washington D.C. Other Routes are all routes outside the Northeast Corridor. Published by the EPA. Updated April 2021.

Intercity Rail Northeast Corridorintercity-rail-northeast-corridor
USUnited States
2020

Emission Intensity of Intercity Rail - Northeast Corridor. Intercity rail: Amtrak long-distance rail between major cities. Northeast Corridor extends from Boston to Washington D.C. Other Routes are all routes outside the Northeast Corridor. Published by the EPA. Updated April 2021.

Intercity Rail Other Routesintercity-rail-other-routes
USUnited States
2020

Emission Intensity of Intercity Rail Other Routes. Intercity rail: Amtrak long-distance rail between major cities. Northeast Corridor extends from Boston to Washington D.C. Other Routes are all routes outside the Northeast Corridor. Published by the EPA. Updated April 2021.

International Railinternational-rail
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of International Rail. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Light Rail and Tramlight-rail-and-tram
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Light Rail and Tram. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

London Undergroundunderground
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of London Underground. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Metropolitan Averagemetropolitan-average
NZNew Zealand
2020

Emission Intensity of Metropolitan Average. Provided by the Ministry for the Environment. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Metropolitan Dieselmetropolitan-diesel
NZNew Zealand
2020

Emission Intensity of Metropolitan Diesel. Provided by the Ministry for the Environment. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

National Railnational-rail
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of National Rail. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Sea Travel

Calculate emissions generated by sea travel.

Sea Travel Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
routestring[]List of location ids.planned

Sea Travel Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "ferry-foot-passenger",
"parameters": {
"distance": 20
}
}'

Sea Travel Emission Factors

Name
ID
Source
Region
Year
Description
Ferry Average All Passangerferry-all-passenger
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Average All Passenger. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Ferry Car Passengerferry-car-passenger
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Ferry Car Passenger. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Ferry Foot Passengerferry-foot-passenger
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Ferry Foot Passenger. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Road Transport

Calculate emissions generated by road transport.

Road Transport Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
weightnumberTotal weight transported in the defined unit.Yes
weight_unitstringUnit of mass. Supported values: kg and t.Not
routestring[]List of location ids.planned

Road Transport Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "hgv-articulated-50-laden",
"parameters": {
"distance": 300,
"weight": 100
}
}'

Road Transport Emission Factors

Name
ID
Source
Region
Year
Description
Freitght Goods Truckfreight-goods-truck
NZNew Zealand
2020

Emission intensity of freighting goods truck. Generic Value. Road freight for freighting goods. Pre 2010 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial battery electric vehicle above 3000cccommercial-battery-electric-vehicle-above-3000cc
NZNew Zealand
2020

Emission intensity of commercial battery electric vehicle. Above 3000cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial battery electric vehicle between 1350 and 1600cccommercial-battery-electric-vehicle-between-1350-and-1600cc
NZNew Zealand
2020

Emission intensity of commercial battery electric vehicle. Between 1350 and 1600cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial battery electric vehicle between 1600 and 2000cccommercial-battery-electric-vehicle-between-1600-and-2000cc
NZNew Zealand
2020

Emission intensity of commercial battery electric vehicle. Between 1600 and 2000cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial battery electric vehicle between 2000 and 3000cccommercial-battery-electric-vehicle-between-2000-and-3000cc
NZNew Zealand
2020

Emission intensity of commercial battery electric vehicle. Between 2000 and 3000cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial battery electric vehicle below 1350cccommercial-battery-electric-vehicle-below-1350cc
NZNew Zealand
2020

Emission intensity of commercial battery electric vehicle. Below 1350cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial diesel plug-in hybrid vehicle (mainly electric) above 3000cccommercial-diesel-plug-in-hybrid-vehicle-mainly-electric-above-3000cc
NZNew Zealand
2020

Emission intensity of commercial diesel plug-in hybrid vehicle. Mainly electric. Above 3000cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial diesel plug-in hybrid vehicle (mainly electric) below 1350cccommercial-diesel-plug-in-hybrid-vehicle-mainly-electric-below-1350cc
NZNew Zealand
2020

Emission intensity of commercial diesel plug-in hybrid vehicle. Mainly electric. Below 1350cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial diesel plug-in hybrid vehicle (mainly electric) between 1350 and 1600cccommercial-diesel-plug-in-hybrid-vehicle-mainly-electric-between-1350-and-1600cc
NZNew Zealand
2020

Emission intensity of commercial diesel plug-in hybrid vehicle. Mainly electric. Between 1350 and 1600cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Commercial diesel plug-in hybrid vehicle (mainly electric) between 1600 and 2000cccommercial-diesel-plug-in-hybrid-vehicle-mainly-electric-between-1600-and-2000cc
NZNew Zealand
2020

Emission intensity of commercial diesel plug-in hybrid vehicle. Mainly electric. Between 1600 and 2000cc. Light commercial vehicles. Post 2015 Fleet. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Air Transport

Calculate emissions generated by air transport.

Air Transport Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
weightnumberTotal weight transported in the defined unit.Yes
weight_unitstringUnit of mass. Supported values: kg and t.Not
routestring[]List of IATA airport codes.No

Air Transport Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "freight-plane-domestic",
"parameters": {
"distance": 500,
"weight": 100
}
}'

Air Transport Emission Factors

Name
ID
Source
Region
Year
Description
Air Cargo below 500kmair-cargo-below-500km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 1. More than 100 tonnes, <500 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Air Cargo between 500 and 1000kmair-cargo-between-500-and-1000km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 2. More than 100 tonnes, 500 - 1000 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Air Cargo between 1000 and 3500kmair-cargo-between-1000-and-3500km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 3. More than 100 tonnes, 1000 - 3500 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Air Cargo above 3500kmair-cargo-above-3500km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 4. More than 100 tonnes, >3500 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Air Cargo between 10 and 25t below 500kmair-cargo-between-10-and-25t-below-500km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 1. 10 to 25 tonnes <500 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Air Cargo between 26 and 100t below 500kmair-cargo-between-26-and-100t-below-500km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 1. 26 to 100 tonnes, <500 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Air Cargo between 10 and 25t between 500km and 1000kmair-cargo-between-10-and-25t-between-500-and-1000km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 2. 10 to 25 tonnes 500 - 1000 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Air Cargo between 26 and 100t between 500 and 1000kmair-cargo-between-26-and-100t-between-500-and-1000km
ADEMELink
FRFrance
2018

Emission Intensity of Air Cargo With Countrails 2. 26 to 100 tonnes, 500 - 1000 kms. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & Ecocalculateur DGAC.

Aircraftaircraft
USUnited States
2021

Emission Intensity of Aircraft. Aircraft: updates due to a methodology change. Published by the EPA. Updated April 2021.

Domestic Freight Flightdomestic-freight-flight
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Domestic Flight (to/from UK). Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Rail Transport

Calculate emissions generated by rail transport.

Rail Transport Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
weightnumberTotal weight transported in the defined unit.Yes
weight_unitstringUnit of mass. Supported values: kg and t.Not
routestring[]List of location ids.planned

Rail Transport Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "freight-train",
"parameters": {
"distance": 500,
"weight": 100
}
}'

Rail Transport Emission Factors

Name
ID
Source
Region
Year
Description
Freight Trainfreight-train
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Freight Train. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021.

Railrail
USUnited States
2021

Emission Intensity of Rail. Published by the EPA. Updated April 2021.

Rail freight KiwiRailrail-freight-kiwirail
NZNew Zealand
2020

Emission intensity of a rail freight (KiwiRail). KiwiRail Holdings Limited is a New Zealand state-owned enterprise responsible for rail operations in New Zealand, and operates inter-island ferries. Trading as KiwiRail and headquartered in Wellington, New Zealand, KiwiRail is the largest rail transport operator in New Zealand (source: https://en.wikipedia.org/wiki/KiwiRail). International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Rail freight transport electricrail-freight-transport-electric
DEGermany
2020

Emission intensity of rail freight transport. Powered by electricity. Data from the Öko-Institut's renewbility technology database. Value applicable to 2020.Provided by the Öko-Institut. Accessed on the 15th of September 2021.

Rail freight transport dieselrail-freight-transport-diesel
DEGermany
2020

Emission intensity of rail freight transport diesel. Diesel fuel. Data from the Öko-Institut's renewbility technology database. Value applicable to 2020.Provided by the Öko-Institut. Accessed on the 15th of September 2021.

Sea Transport

Calculate emissions generated by sea transport.

Sea Transport Parameters

AttributeTypeDescriptionRequiredDefault
distancenumberTotal distance in the defined unit.Yes
distance_unitstringUnit of distance. Supported values: km, mi, nmi, m and ft.Nokm
weightnumberTotal weight transported in the defined unit.Yes
weight_unitstringUnit of mass. Supported values: kg and t.Not
routestring[]List of locations as port codes.planned

Sea Transport Request Example

curl --request POST \
--url 'https://beta.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "sea-container-ship",
"parameters": {
"distance": 500,
"weight": 100
}
}'

Sea Transport Emission Factors

Name
ID
Source
Region
Year
Description
Bulk carrier above 200.000 dwtbulk-carrier-above-200000dwt
NZNew Zealand
2020

Emission intensity of a bulk carrier. Above 200000 dwt. The dwt value corresponds to deadweight tonnage, a measure of how much weight a ship can carry. International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Bulk carrier averagebulk-carrier-average
NZNew Zealand
2020

Emission intensity of a bulk carrier. Average value.International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Bulk carrier below 9.999 dwtbulk-carrier-below-9999dwt
NZNew Zealand
2020

Emission intensity of a bulk carrier. Between 0 and 9999 dwt. The dwt value corresponds to deadweight tonnage, a measure of how much weight a ship can carry. International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Bulk carrier between 10.000 and 34.999 dwtbulk-carrier-between-10000-and-34999dwt
NZNew Zealand
2020

Emission intensity of a bulk carrier. Between 10000 and 349990 dwt. The dwt value corresponds to deadweight tonnage, a measure of how much weight a ship can carry. International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Bulk carrier between 35.000 and 59.999 dwtbulk-carrier-between-35000-and-59999dwt
NZNew Zealand
2020

Emission intensity of a bulk carrier. Between 35000 and 59999 dwt. The dwt value corresponds to deadweight tonnage, a measure of how much weight a ship can carry. International shipping. International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Bulk carrier between 60.000 and 99.999 dwtbulk-carrier-between-60000-and-99999dwt
NZNew Zealand
2020

Emission intensity of a bulk carrier. Between 60000 and 99999 dwt. The dwt value corresponds to deadweight tonnage, a measure of how much weight a ship can carry. International shipping. International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Bulk carrier between 100.000 and 199.999 dwtbulk-carrier-between-100000-and-199999dwt
NZNew Zealand
2020

Emission intensity of a bulk carrier. Between 100000 and 199999 dwt. The dwt value corresponds to deadweight tonnage, a measure of how much weight a ship can carry. International shipping. New Zealand. Published by the Ministry for the Environment of New Zealand in 2020.

Cargo HFO MGO between 10.000 and 20.000tcargo-hfo-mgo-between-10000-and-20000t
ADEMELink
FRFrance
2020

Emission Intensity of Cargo Ship. Heavy Fuel Oil & Marine Gas Oil. 10 000 - 20 000 tonnes. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & GLEC Framework.

Cargo HFO MGO to 10.000tcargo-hfo-mgo-to-10000t
ADEMELink
FRFrance
2020

Emission Intensity of Cargo Ship. Heavy Fuel Oil & Marine Gas Oil. Less than 10 000 tonnes. Continental France. 2020 Factor. Updated May 2020. Published by the Agence de l'Environnement et de la Maîtrise de l'Énergie. Provided by the GT Transport Base Carbone & GLEC Framework.

Chemical Tanker to 4.999 dwtsea-chemical-tanker-to–4999dwt
DEFRALink
GBUnited Kingdom
2021

Emission Intensity of Sea Chemical Tanker. Available in DEFRA's Greenhouse Gas Reporting: Conversion Factors 2021. 0–4999 dwt