Classifications Endpoint version: V1V1 ADD-ONADD-ON

Many sources link emission factors (opens in a new tab) 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 (opens in a new tab)):

For a more in-depth view on how Climatiq works with classification schemes, view the classification guide.

Estimate

POST Calculate total estimated emissions produced for a particular activity, as described by an industry classification scheme such as ISIC (opens in a new tab) or NACE (opens in a new tab). All requests are performed by sending a POST request to the following endpoint:

https://api.climatiq.io/classifications/v1/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 (opens in a new tab), 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.

Request

This endpoint accepts the following parameters:

curl --request POST \
  --url https://api.climatiq.io/classifications/v1/estimate \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
    "classification": {
        "classification_type": "isic4",
        "classification_code": "25",
        "source": "EXIOBASE"
    },
    "parameters": {
        "money": 25.0,
        "money_unit": "usd"
    }
}'

Response

This endpoint returns an EstimationWithSourceTrail, which includes the total amount of emissions in kgCO2e and the emission factor used to calculate the emissions.

{
    "co2e": 49.25,
    "co2e_unit": "kg",
    "co2e_calculation_method": "ar5",
    "co2e_calculation_origin": "source",
    "emission_factor": {
        "name": "Fabricated metal products/except machinery and equipment",
        "activity_id": "metal_products-type_fabricated_metal_products_except_machinery_equipment",
        "id": "f9682106-3615-4d90-b200-89c7b938a256",
        "access_type": "public",
        "source": "EXIOBASE",
        "source_dataset": "EXIOBASE 3",
        "year": 2019,
        "region": "IN",
        "category": "Fabricated Metal Products",
        "source_lca_activity": "unknown",
        "data_quality_flags": []
    },
    "constituent_gases": {
        "co2e_total": 49.25,
        "co2e_other": null,
        "co2": null,
        "ch4": null,
        "n2o": null
    },
    "activity_data": {
        "activity_value": 22.35,
        "activity_unit": "eur"
    },
    "audit_trail": "enabled",
    "source_trail": [
        {
            "data_category": "emission_factor",
            "name": "Fabricated metal products/except machinery and equipment",
            "source": "EXIOBASE",
            "source_dataset": "EXIOBASE 3",
            "year": "2019",
            "region": "IN",
            "region_name": "India"
        }
    ]
}