Autopilot (preview 3) ADD-ONADD-ON

Autopilot is an AI-powered calculation endpoint designed to automate spend- and activity-based emission estimates. It uses a proprietary natural language processing (NLP) model paired with Climatiq’s scientific expertise to streamline complex emission calculations, making carbon insights accessible to non-experts.

Autopilot significantly reduces the time and manual effort spent identifying the appropriate emission factors and mapping activity data. Capable of ingesting any taxonomy and unstructured data, this feature matches raw text content and contextual information to find the correct emission factors and delivers accurate and compliant emission estimates.

Autopilot's matching algorithm consistently refines its precision. This is achieved through active feedback and continuous improvement of the underlying NLP model.

Domains

Calls to autopilot requires that the user specifies a domain. Domains represent a collection of data and model, defined for specific use cases, and restricts the sources used for matching emission factors. You can use the source and exclude_source parameters in the request body to define which sources to include or exclude, as long as they are part of the sources available for the chosen domain (see table below).

Suggest

POST Return a number of suggested emission factors. The Suggest endpoint finds emission factors that you can use to calculate emissions with via the Estimate endpoint. You can adjust the number of suggestions to return, or filter the results by source, year, region, unit, or lifecycle activity. Suggestions are ranked, with the most relevant result presented first.

https://preview.api.climatiq.io/autopilot/v1-preview3/suggest

Request

This endpoint accepts the following parameters:

curl --request POST \
  --url https://preview.api.climatiq.io/autopilot/v1-preview3/suggest \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
    "suggest": {
        "domain": "general",
        "text": "Cement"
    },
    "max_suggestions": 2
}'

Response

The response includes a list of emission factors and details about its relevance:

{
    "results": [
        {
            "suggestion_id": "giytkntbha4weljxmjstqljugqydkllbmfrdsljqga2ggylemu4wmzdfme-g4ydkolgmi2gkndcmy2timzymm4wkzrtgaydambqgaydambqgayq",
            "emission_factor": {
                "sector": "Materials and Manufacturing",
                "category": "Building Materials",
                "name": "Cement",
                "unit_type": "Money",
                "unit": "kg/usd",
                "source": "EPA",
                "source_dataset": "Supply Chain Greenhouse Gas Emission Factors v1.3",
                "year": 2022,
                "year_released": 2024,
                "region": "US",
                "region_name": "United States of America (the)",
                "description": "Emission intensity of supply chain (with margins i.e. cradle to shelf) in US dollars spend on: cement manufacturing. This factor is representative of the described goods or services category as defined by the 2017 version of the North American Industry Classification System (NAICS). Refer to the source for the source-specific data quality assessment. Retrieved from Supply Chain Factors Dataset v1.3.",
                "source_link": "https://cfpub.epa.gov/si/si_public_record_Report.cfm?dirEntryId=349324&Lab=CESER",
                "source_lca_activity": "cradle_to_shelf",
                "data_quality_flags": [],
                "access_type": "public"
            },
            "suggestion_details": {
                "similarity_score": 0.97,
                "confidence": "high"
            }
        },
        {
            "suggestion_id": "gezdoyrymfsdoljzg43geljug5swillcmq3taljuhaztozrwgrqtkobsmi-g4ydkolgmi2gkndcmy2timzymm4wkzrtgaydambqgaydambqgayq",
            "emission_factor": {
                "sector": "Materials and Manufacturing",
                "category": "Building Materials",
                "name": "Cement mortar",
                "unit_type": "Volume",
                "unit": "kg/m3",
                "source": "OEKOBAUDAT",
                "source_dataset": "OEKOBAUDAT 2023-I",
                "year": 2018,
                "year_released": 2023,
                "region": "DE",
                "region_name": "Germany",
                "description": "Emission intensity of cement mortar. The lifecycle assessment for modules A1-A3 includes: the extraction and processing of raw materials (A1) their transportation to the manufacturer (A2) and the actual manufacturing of the product (A3). Retrieved from the Oekobaudat database v20.19.120.",
                "source_link": "https://www.oekobaudat.de/en/service/downloads.html",
                "source_lca_activity": "cradle_to_gate",
                "data_quality_flags": [],
                "access_type": "public"
            },
            "suggestion_details": {
                "similarity_score": 0.94,
                "confidence": "high"
            }
        }
    ]
}

Estimate

POST Calculate an emission estimation for an emission factor match. To calculate an emission estimation you will need to first find an emission factor using the Suggest endpoint. When you have selected an emission factor, you can request for a calculation using the following parameters.

https://preview.api.climatiq.io/autopilot/v1-preview3/suggest/estimate

Request

curl --request POST \
  --url https://preview.api.climatiq.io/autopilot/v1-preview3/suggest/estimate \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
	"suggestion_id": "mqydemtghbrtillegaztsljugm2dsllbga2wcljsgfrtcobrmm3dqnbxge-ge3gcmzvgy3tmzbqgm2timbqmy4dimtegaydambqgaydambqgayq",
	"parameters": {
		"weight": 100,
        "weight_unit": "kg"
	}
}'

Response

The response includes the CO2e estimate and details about the calculation.

{
    "estimate": {
        "co2e": 79.52,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "source",
        "emission_factor": {
            "name": "Cement (CEM II 42.5)",
            "activity_id": "building_materials-type_cement_cem_ii_42.5",
            "id": "d022f8c4-d039-4349-a05a-21c181c68471",
            "access_type": "public",
            "source": "OEKOBAUDAT",
            "source_dataset": "OEKOBAUDAT 2023-I",
            "year": 2018,
            "region": "DE",
            "category": "Building Materials",
            "source_lca_activity": "cradle_to_gate",
            "data_quality_flags": []
        },
        "constituent_gases": {
            "co2e_total": 79.52,
            "co2e_other": null,
            "co2": null,
            "ch4": null,
            "n2o": null
        },
        "activity_data": {
            "activity_value": 100,
            "activity_unit": "kg"
        },
        "audit_trail": "enabled"
    },
    "source_trail": [
        {
            "data_category": "emission_factor",
            "name": "Cement (CEM II 42.5)",
            "source": "OEKOBAUDAT",
            "source_dataset": "OEKOBAUDAT 2023-I",
            "year": "2018",
            "region": "DE",
            "region_name": "Germany"
        }
    ]
}

Emission Factor License

If you attempt to estimate with an emission factor with a premium access type and you do not have access to this premium dataset, an estimation will not be performed. These datasets require a separate purchase license. Contact us to obtain a license for the dataset you wish to purchase.

One-shot Estimate

POST Calculate total estimated emissions produced for an autopilot matched activity, in kgCO2e. All requests are performed by sending a POST request to the following endpoint.

Estimations can be performed by using free-text input. It will automatically perform an emission calculation with the best match, using the emission factor with the top similarity score from the list of factors provided in the Suggest endpoint.

https://preview.api.climatiq.io/autopilot/v1-preview3/estimate

Request

Receive an estimation for the best emission factor match using the following parameters.

curl --request POST \
  --url https://preview.api.climatiq.io/autopilot/v1-preview3/estimate \
  --header "Authorization: Bearer $CLIMATIQ_API_KEY" \
  --data '{
	"domain": "general",
	"text": "Steel",
	"parameters": {
		"money": 100,
        "money_unit": "usd"
	}
}'

Response

The response includes the CO2e estimate and details about the calculation.

{
    "estimate": {
        "co2e": 47,
        "co2e_unit": "kg",
        "co2e_calculation_method": "ar4",
        "co2e_calculation_origin": "climatiq",
        "emission_factor": {
            "name": "Cast iron and steel",
            "activity_id": "metals-type_cast_iron_steel",
            "id": "15e75a68-b485-494b-8cbc-398d417207a7",
            "access_type": "public",
            "source": "EPA",
            "source_dataset": "Supply Chain Factors Dataset (commodities)",
            "year": 2018,
            "region": "US",
            "category": "Metals",
            "source_lca_activity": "cradle_to_shelf",
            "data_quality_flags": []
        },
        "constituent_gases": {
            "co2e_total": null,
            "co2e_other": 0.7,
            "co2": 41.3,
            "ch4": 0.2,
            "n2o": 0
        },
        "activity_data": {
            "activity_value": 100,
            "activity_unit": "usd"
        },
        "audit_trail": "enabled"
    },
    "calculation_details": {
        "similarity_score": 0.91,
        "confidence": "high"
    },
    "source_trail": [
        {
            "data_category": "emission_factor",
            "name": "Cast iron and steel",
            "source": "EPA",
            "source_dataset": "Supply Chain Factors Dataset (commodities)",
            "year": "2018",
            "region": "US",
            "region_name": "United States of America (the)"
        }
    ]
}

Dry-runs

If you attempt to estimate without suggestion using a domain that contains a source your API key does not have access to, the estimate will still work, but the CO2e values will not be provided. This is so you can evaluate how good matches would be using different domains and sources, before purchasing commercial access to the data.