This guide will walk you through making your first estimation with the Climatiq API using a real-life example.


Introduction to Emission Factors

Climatiq API estimates how much greenhouse gasses your activities emit using validated conversion factors known as emission factors. An emission factor is a way to convert different human activities into greenhouse gases in terms of CO2 equivalent (opens in a new tab) (CO2e), usually expressed in kilograms. Climatiq can answer questions like:

  1. How much CO2e is emitted taking the train from Paris to Berlin?
  2. How much CO2e is emitted spending $1,000 on soft drinks in the US?
  3. How much CO2e is emitted staying a night at a hotel in China?

Watch our step-by-step video tutorial

Getting started with Climatiq (opens in a new tab)

Your First Estimate

Let's estimate the greenhouse gas emissions of an average UK household based on electricity consumption (4,200 kWh per year) using the emission factor for the activity electricity-energy_source_grid_mix. This factor represents the average emission for the electricity grid.


Use curl (opens in a new tab) to make an API call:

An API call to this endpoint looks like the block below.

curl --request POST \
--url \
--header 'Authorization: Bearer API_KEY' \
--data '{
"emission_factor": {
"activity_id": "electricity-supply_grid-source_residual_mix",
"data_version": "^1"
"energy": 4200,
"energy_unit": "kWh"

In this example, we provide the parameters argument for the calculations and they indicate that we'd like it to calculate the emissions for 4.200 kWh.


You should get a response from the API back that looks like this:

"co2e": 4381.818,
"co2e_unit": "kg",
"co2e_calculation_method": "ar5",
"co2e_calculation_origin": "source",
"emission_factor": {
"name": "Electricity supplied from grid - residual mix",
"activity_id": "electricity-supply_grid-source_residual_mix",
"id": "ac3acf95-0d5e-4a95-b4bb-b816286ab249",
"access_type": "public",
"source": "GHG Protocol",
"source_dataset": "GHG Emissions Calculation Tool",
"year": 2021,
"region": "EE",
"category": "Electricity",
"source_lca_activity": "electricity_generation",
"data_quality_flags": [
"constituent_gases": {
"co2e_total": 4381.818,
"co2e_other": null,
"co2": 4381.818,
"ch4": null,
"n2o": null
"activity_data": {
"activity_value": 4200,
"activity_unit": "kWh"
"audit_trail": "selector"

The API returns quite a few values but the most relevant values are co2e and co2e_unit, which together describe how much CO2e is emitted by the given activity. In this case, yearly energy consumption emits approximately 4381 kg of CO2e.

(Check out this table to see a description of every attribute in the response)

If you've made it this far you've made your first API call and seen the results in your terminal!

Next Steps