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://beta2.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 tonnes or kilograms and distance in kilometres 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.

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

Content-Type: application/json

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.

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

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

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

AttributeTypeDescription
sectorstringFilters by emission factor sectoroptional
categorystringFilters by emission factor categoryoptional
sourcestringFilters emission factors by data sourceoptional
regionstringFilters emission factors by geographic regionoptional
yearstringFilters emission factors by year factor applies tooptional

Note all request paramaters default to all.

curl --request GET \
--url 'https://beta2.api.climatiq.io/emission-factors?source=BEIS&year=2021' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json'

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

AttributeTypeDescription
resultsarrayList of emission factors.

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

AttributeTypeDescription
idstringEmission factor ID.
namestringEmission factor name.
categorystringEmission factor category.
sectorstringEmission factor sector.
sourcestringEmission factor publisher.
source_linkstringLink to emission factor publisher.
uncertaintynumber or nullEmission factor uncertainty factor (%).
yearstringYear for which the emission factor applies.
regionstringGeographic region to which the emission factor applies (UN/LOCODE).
region_namestringGeographic region to which the emission factor applies (in English).
descriptionstringEmission factor description.
unit_typearrayA list of Unit types that this emission factor accepts.
unitstringThe unit in which the factor field is expressed.
factornumberEmission factor value, expressed in value provided in the unit field.
{
"results": [
{
"id": "fuel_type_aviation_fuel_kerosene_transport-activity_combustion",
"name": "Aviation fuel (Kerosene)",
"category": "Fuel",
"sector": "Energy",
"source": "MfE",
"source_link": "https://environment.govt.nz/publications/measuring-emissions-detailed-guide-2020/",
"uncertainty": null,
"year": "2020",
"region": "NZ",
"region_name": "New Zealand",
"description": "Emission intensity of aviation fuel (Kerosene)/Jet A1. Published by the Ministry for the Environment of New Zealand in 2020.",
"unit_type": ["Volume"],
"unit": "kg-CO2e/l",
"factor": 2.62632
},
{...},
{...}
]
}

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

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

The request parameters are the same as for Emission Query

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

AttributeTypeDescription
resultsarrayList of years available for the given query.
{
"results": [
"2021",
"2020",
"2018"
]
}

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

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

The request parameters are the same as for Emission Query

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

AttributeTypeDescription
resultsarrayList of sources available for the given query.
{
"results": [
"ADEME",
"BEIS"
]
}

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

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

The request parameters are the same as for Emission Query

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

AttributeTypeDescription
resultsarrayList of regions available for the given query.

Every region contains:

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

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

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

The request parameters are the same as for Emission Query

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

AttributeTypeDescription
resultsarrayList of categories available for the given query.
{
"results": [
"Accommodation",
"Air Transport",
"Air Travel",
"Electricity",
"Fuel",
"Rail Transport",
"Rail Travel",
"Road Transport",
"Road Travel",
"Sea Transport",
"Sea Travel",
"Treatment",
"Vehicle"
]
}

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

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

The request parameters are the same as for Emission Query

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

AttributeTypeDescription
resultsarrayList of sectors available for the given query.
{
"results": [
"Energy",
"Transport"
]
}

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

https://beta2.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.

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

AttributeTypeDescription
emission_factorSelectorEmission factor ID or selection parameters selector.required
parametersParametersEmission factor parameters. The parameter object changes depending on the EF selected.required
persistPersistencePersist the estimate to the analytics dashboard.optional
metadataMetadataProvide optional metadata when persisting the estimate.optional
curl --request POST \
--url https://beta2.api.climatiq.io/estimate \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"parameters":{
"distance": 10,
"distance_unit": "km"
},
"metadata": {
"scope": "2",
"category": "string"
}
}'

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

AttributeTypeDescription
co2enumberEmission factor carbon dioxide equivalent.
co2e_unitstringThe unit in which the co2e field is expressed.
idstringThe emission factor ID.
sourcestringPublisher of the emission factor.
yearstringYear for which the emission factor applies.
regionstringGeographic region to which the emission factor applies.
categorystringEmission factor category.
{
"category": "Vehicle",
"co2e": 1.7147999999999999,
"co2e_unit": "kg",
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"region": "GB",
"source": "BEIS",
"year": "2021"
}

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

https://beta2.api.climatiq.io/batch
[
{
"emission_factor": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"parameters":{
"distance": 10,
"distance_unit": "km"
}
},
{
"emission_factor": "wrong_id",
"parameters":{
"weight": 10,
"weight_unit": "kg"
}
}
]

AttributeTypeDescription
arrayList of estimation operations. Every operation should follow the same syntax followed by the estimate request object.
curl --request POST \
--url https://beta2.api.climatiq.io/batch \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '[
{
"emission_factor": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"parameters":{
"distance": 10,
"distance_unit": "km"
}
},
{
"emission_factor": "wrong_id",
"parameters":{
"weight": 10,
"weight_unit": "kg"
}
}
]'

The response includes a list of estimate results as describe in estimate Response.

AttributeTypeDescription
resultsarrayList of results for every operation.

If one or more estimations fail, the failed result will contain an error code and message:

AttributeTypeDescription
errorstringError code
messagestringError message
{
"results": [
# Successful operation
{
"co2e": 1.7147999999999999,
"co2e_unit": "kg",
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Vehicle"
},
# Failed operation
{
"error": "not_found",
"message": "No emission factors could be found using the current query."
}
]
}

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

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

AttributeTypeDescriptionDefault
emission_factorstring, objectEmission factor ID or query.required
"emission_factor": "freight-goods-truck"

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

AttributeTypeDescriptionDefault
idstringEmission factor ID.required
sourcestringEmission factor data source name.optional
regionstringGeographic region to which the emission factor applies.optional
yearstringYear for which the emission factor applies.optional
"emission_factor": {
"id": "freight-goods-truck",
"source": "MfE",
"region": "NZ",
"year": "2020"
}

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

Unit
volumeDetails
energyDetails
weightDetails
distanceDetails
weight over distanceDetails
passenger over distanceDetails
flight distanceDetails
weight over flight distanceDetails
digitalDetails
timeDetails
amount over timeDetails
amountDetails
"parameters": {
"volume": 10,
"volume_unit": "l",
...
}

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.

AttributeTypeDescriptionDefault
persistbooleanPersist the estimate to the analytics dashboard.trueoptional
{
"persist": false,
}

When persisting data, 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.

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 provided.optional
"metadata": {
"scope": "2",
"category": "string",
}

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

AttributeTypeDescriptionValuesDefault
volumenumberVolume in the defined unitrequired
volume_unitstringUnit of volumel, m3 or mlloptional
{
...
"parameters": {
"volume": 15,
"volume_unit": "l"
},
...
}

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

AttributeTypeDescriptionValuesDefault
energynumberEnergy in the defined unitrequired
energy_unitstringUnit of energykWh, TJ or GJkWhoptional
{
...
"parameters": {
"energy": 30,
"energy_unit": "TJ"
},
...
}

Calculate emissions produced by total weight of material consumed, utilised or transported in a process or activity, expressed in kilograms or tonnes.

AttributeTypeDescriptionValuesDefault
weightnumberWeight in the defined unitrequired
weight_unitstringUnit of weightkg or tkgoptional
{
...
"parameters": {
"weight": 80,
"weight_unit": "t"
},
...
}

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

AttributeTypeDescriptionValuesDefault
distancenumberDistance in the defined unitrequired
distance_unitstringUnit of distancekm, mi, nmi, m or ftkmoptional
{
...
"parameters": {
"distance": 100,
"distance_unit": "mi"
},
...
}

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

AttributeTypeDescriptionValuesDefault
weightnumberWeight in the defined unitrequired
weight_unitstringUnit of weightkg or tkgoptional
distancenumberDistance in the defined unitrequired
distance_unitstringUnit of distancekm, mi, nmi, m, ftkmoptional
{
...
"parameters": {
"weight": 80,
"weight_unit": "t",
"distance": 100,
"distance_unit": "mi"
},
...
}

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

AttributeTypeDescriptionValuesDefault
passengersnumberNumber of passengers1required
distancenumberDistance in the defined unitrequired
distance_unitstringUnit of distancekm, mi, nmi, m or ftkmoptional
{
...
"parameters": {
"passengers": 4,
"distance": 100,
"distance_unit": "mi"
},
...
}

Calculate emissions produced by a single passenger flight from one location to another (expressed in IATA codes).

AttributeTypeDescriptionValuesDefault
routearrayList of IATA airport codes.[]required
{
...
"parameters": {
"route": ["PMI", "BER"],
},
...
}

Calculate emissions produced by moving a weight from one location to another (expressed in IATA codes).

AttributeTypeDescriptionValuesDefault
weightnumberWeight in the defined unitrequired
weight_unitstringUnit of weightkg or tkgoptional
routearrayList of IATA airport codes.[]required
{
...
"parameters": {
"weight": 80,
"weight_unit": "kg",
"route": ["PMI", "BER"],
},
...
}

Calculate emissions produced by the storage of data, by .

AttributeTypeDescriptionValuesDefault
sizenumberSize in the defined unitrequired
size_unitstringUnit of sizeMB or GB, TBMBoptional
{
...
"parameters": {
"size": 3,
"size_unit": "GB"
},
...
}

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

AttributeTypeDescriptionValuesDefault
timenumberTime amountrequired
unit_timestringUnit of timeh or m, shoptional
{
...
"parameters": {
"time": 3,
"unit_time": "m"
},
...
}

Calculate emissions by a unit amount (CPU-hour...) in a given time expressed in hours, minutes or seconds.

AttributeTypeDescriptionValuesDefault
amountnumberCPU-hour... amountrequired
timenumberTime amountrequired
unit_timestringUnit of timeh or m, shoptional
{
...
"parameters": {
"amount": 15,
"time": 3,
"unit_time": "m"
},
...
}

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

AttributeTypeDescriptionValuesDefault
amountnumberUnit amountrequired
{
...
"parameters": {
"amount": 3,
},
...
}

Calculate emissions generated by electricity consumption.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "electricity-energy_source_coal_fired_plant",
"parameters":{
"energy": 10,
"energy_unit": "kWh"
}
}'

{
"co2e": 10.600000000000001,
"co2e_unit": "kg",
"id": "electricity-energy_source_coal_fired_plant",
"source": "ADEME",
"year": "2018",
"region": "FR",
"category": "Electricity"
}

Calculate emissions generated by fuel consumption.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "fuel_type_avtur-fuel_use_aviation",
"parameters":{
"volume": 10,
"volume_unit": "l"
}
}'

{
"co2e": 25.4514,
"co2e_unit": "kg",
"id": "fuel_type_avtur-fuel_use_aviation",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Fuel"
}

Calculate emissions generated by CPU utilization in cloud computing data centers.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "cpu-provider_aws-region_af_south_1",
"parameters":{
"amount": 15,
"time": 3,
"unit_time": "m"
}
}'

{
"co2e": 0.09882405,
"co2e_unit": "kg",
"id": "cpu-provider_aws-region_af_south_1",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "CPU"
}

Calculate emissions generated by memory utalization in cloud computing data centers.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "memory-provider_aws-region_af_south_1",
"parameters": {
"size": 3,
"size_unit": "GB"
}
}'

{
"co2e": 0.00123867,
"co2e_unit": "kg",
"id": "memory-provider_aws-region_af_south_1",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Memory"
}

Calculate emissions generated by data storage in cloud computing data centers.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "storage-provider_aws-region_af_south_1-type_hdd",
"parameters":{
"size": 3,
"size_unit": "GB"
}
}'

{
"co2e": 2.05389e-6,
"co2e_unit": "kg",
"id": "storage-provider_aws-region_af_south_1-type_hdd",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Storage"
}

Calculate emissions generated by networking between cloud computing data centers.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "networking-provider_aws-region_af_south_1",
"parameters": {
"size": 3,
"size_unit": "GB"
}
}'

{
"co2e": 0.0031598399999999997,
"co2e_unit": "kg",
"id": "networking-provider_aws-region_af_south_1",
"source": "CCF",
"year": "2021",
"region": "ZA-CPT",
"category": "Networking"
}

Calculate emissions generated by a hotel stay.

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

{
"co2e": 549.9000000000001,
"co2e_unit": "kg",
"id": "accommodation_type_hotel_stay",
"source": "BEIS",
"year": "2021",
"region": "MV",
"category": "Accommodation"
}

Calculate emissions generated by a vehicle travelling over a distance.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"parameters":{
"distance": 100,
"distance_unit":"km"
}
}'

{
"co2e": 17.148,
"co2e_unit": "kg",
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-engine_size_na-vehicle_age_na-vehicle_weight_na",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Vehicle"
}

Calculate emissions generated by road travel.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "passenger_vehicle-vehicle_type_car-fuel_source_na-distance_short-engine_size_na",
"parameters":{
"distance": 100,
"distance_unit":"km"
"passengers": 4
}
}'

{
"co2e": 13.4,
"co2e_unit": "kg",
"id": "passenger_vehicle-vehicle_type_car-fuel_source_na-distance_short-engine_size_na",
"source": "ADEME",
"year": "2018",
"region": "FR",
"category": "Road Travel"
}

Calculate emissions generated by air travel.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "passenger_flight-route_type_na-aircraft_type_na-distance_lt_300mi-class_na-contrails_na",
"parameters":{
"distance": 100,
"distance_unit":"km",
"passengers": 4
}
}'

{
"co2e": 51.200986056,
"co2e_unit": "kg",
"id": "passenger_flight-route_type_na-aircraft_type_na-distance_lt_300mi-class_na-contrails_na",
"source": "EPA",
"year": "2021",
"region": "US",
"category": "Air Travel"
}

Calculate emissions generated by rail travel.

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

{
"co2e": 35.542432068,
"co2e_unit": "kg",
"id": "passenger_train-route_type_commuter_rail-fuel_source_na",
"source": "EPA",
"year": "2021",
"region": "US",
"category": "Rail Travel"
}

Calculate emissions generated by sea travel.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "passenger_ferry-route_type_na-fuel_source_na",
"parameters":{
"distance": 100,
"distance_unit":"km",
"passengers": 4
}
}'

{
"co2e": 45.144,
"co2e_unit": "kg",
"id": "passenger_ferry-route_type_na-fuel_source_na",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Sea Travel"
}

Calculate emissions generated by transport of goods by road.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "freight_vehicle-vehicle_type_commercial_truck-fuel_source_na-vehicle_weight_na-percentage_load_na",
"parameters": {
"weight": 10,
"weight_unit": "t",
"distance": 100,
"distance_unit": "km"
}
}'

{
"co2e": 135.0,
"co2e_unit": "kg",
"id": "freight_vehicle-vehicle_type_commercial_truck-fuel_source_na-vehicle_weight_na-percentage_load_na",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Road Transport"
}

Calculate emissions generated by transport of goods by air.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "freight_flight-route_type_domestic-distance_na-weight_na-contrails_included",
"parameters": {
"weight": 10,
"weight_unit": "t",
"distance": 100,
"distance_unit": "km"
}
}'

{
"co2e": 4493.629999999999,
"co2e_unit": "kg",
"id": "freight_flight-route_type_domestic-distance_na-weight_na-contrails_included",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Air Transport"
}

Calculate emissions generated by transport of goods by rail.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "freight_train-route_type_na-fuel_type_na",
"parameters": {
"weight": 10,
"weight_unit": "t",
"distance": 100,
"distance_unit": "km"
}
}'

{
"co2e": 27.82,
"co2e_unit": "kg",
"id": "freight_train-route_type_na-fuel_type_na",
"source": "BEIS",
"year": "2021",
"region": "GB",
"category": "Rail Transport"
}

Calculate emissions generated by transport of goods by sea.

curl --request POST \
--url 'https://beta2.api.climatiq.io/estimate' \
--header 'Authorization: Bearer API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emission_factor": "sea_freight-vessel_type_bulk_carrier-route_type_na-vessel_length_na-tonnage_gt_200000dwt-fuel_source_na",
"parameters": {
"weight": 10,
"weight_unit": "t",
"distance": 100,
"distance_unit": "km"
}
}'

{
"co2e": 2.535,
"co2e_unit": "kg",
"id": "sea_freight-vessel_type_bulk_carrier-route_type_na-vessel_length_na-tonnage_gt_200000dwt-fuel_source_na",
"source": "MfE",
"year": "2020",
"region": "NZ",
"category": "Sea Transport"
}