Upload and use private emission factors

While the datasets available in the Climatiq API meet a wide range of needs, sometimes there are specific emission factors that are needed for your project that can't be shared publicly - say a licensed dataset or footprints provided from suppliers. Which is why we developed Private Emission Factors, available as an add-on to our Corporate or Commercial tier. This feature allows you to add any emission factors to a secure environment via an uploader in our dashboard, making them available to you right alongside any of the currently available emission factors in our /estimate, /batch and /search endpoints.

Here’s a quick guide on how to upload, manage and use private emission factors.

Log in to your Climatiq account and click on the Private Factors item in the sidebar. Then click “Add emission factors”. This takes you to the file uploader where you can upload your emission factors in a CSV file, using the data structure provided in the template file linked for download (NOTE: this feature is only available to users who have subscribed to it - please get in touch to find out more).

Add private data

Download the template file and replace the single row of dummy data with your emission factors; see Appendix A for a summary of the fields that are accepted by the uploader (* denotes required fields). Then click “Choose file”, browse to where you have saved the CSV you wish to upload and double click. The file name will appear; click “Submit” and the uploader will check the file for errors before adding the emission factors in the file to your list of private emission factors - it will look something like this:

Display private data

You can replace or change factors simply by selecting the factor and deleting it, then uploading a replacement.

curl --request POST \
--url https://beta3.api.climatiq.io/estimate \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data
{
"emission_factor": {
"activity_id": "bananas",
"region": "GB"
},
"parameters": {
"weight": 10,
"weight_unit": "kg"
}
}'

And you will get the following response back.

{
"co2e": 3.4,
"co2e_unit": "kg",
"co2e_calculation_method": "ar4",
"co2e_calculation_origin": "source",
"emission_factor": {
"activity_id": "bananas",
"uuid": "9448b5d5-107c-4669-b232-75fe4bfcf62e",
"id": "bananas",
"access_type": "private",
"source": "Private",
"year": "2021",
"region": "GB",
"category": "Food/Beverages/Tobacco",
"lca_activity": "cradle_to_gate",
"data_quality_flags": []
}
}

This reports that 3.4 kgCO2e were emitted as a result of the production of 10 kg of bananas, based on the emission factor uploaded.

Summary of the fields that are accepted by the uploader (* denotes required fields; the uploader will check these fields for errors)