Calculate emissions with the API

First, familiarize yourself with how we Calculate emissions.

Open the developer menu in the dashboard and navigate to the API Keys section. Click on Add New API Keys. To calculate emissions, your API keys need write permissions.

Search for the appropriate emission factors in our database. You can submit up to 100 calculation options per request to our API.

Use the endpoint /calculate to calculate the emissions.

Pass the calculation_options you have defined to the API. You can calculate up to 100 calculation_options simultaneously.

By default, we round the calculated emissions to the nearest kilogram. If you want a more precise calculation, you can use the fractional_digits parameter to define the maximum number of decimal places returned.

In this example, we calculate the emissions for a trip from Berlin to Munich.

1
2
3
4
5
6
7
8
9
10
11
12
13
{
    "calculation_options": [
        {
            "type": "travel-land",
            "activity": "cars_by_size",
            "specification": "small_car",
            "detail": "average",
            "departure": "Berlin, Germany",
            "destination": "Munich, Germany"
        }
    ],
    "fractional_digits": 2
}

Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
    "kgCO2e": 71.23,
    "calculation_id": "CALC-0000-00000000",
    "results": [
        {
            "type": "travel-land",
            "activity": "cars_by_size",
            "specification": "small_car",
            "detail": "average",
            "value": 586,
            "departure": "Berlin, Germany",
            "destination": "Munich, Germany",
            "kgCO2e": 71.23
        }
    ]
}