What's new at Climatiq

Latest features, enhancements and changelog
September 19, 2023

New travel toolkit, ISO 27001 Certification, UNSPSC support, US energy utilities, new data version

Introducing Climatiq’s travel emission toolkit: Flights, train rides, car journeys, and hotel stays

Our new Travel feature makes it easy to understand the carbon impact of journeys worldwide. Fully aligned with the GHG Protocol, the Travel feature provides distance- and spend-based calculations for scope 3.6 emission reporting to enable more sustainable business travel. Our solution maps seamlessly to any form of travel records like tickets, receipts, itineraries, or expense reports. 

Get started quickly with automatic distance calculations and emission factor selection, including built-in fallbacks. Benefit from flexible address inputs, be it postal/ZIP codes, street addresses, city names, or IATA codes and calculate precise route-specific emission estimates. When more granular travel data is available, dynamic parameters like cabin class, vehicle size, or engine type provide an additional level of accuracy. 

With its new and improved capabilities, the Travel feature replaces our legacy Flight endpoint, which will be deprecated soon. For those who are still using our Flight endpoint, please migrate to the new endpoints.   

Read our guide for travel calculation methodologies and refer to our API documentation for implementation details.

Note that this feature is a paid add-on - please get in touch if you'd like to trial or learn more about this feature.

UNSPSC code support for procurement 

You can now use UNSPSC codes to calculate emissions from spend data. UN Standard Product and Service Codes (UNSPSC) provide a standardized classification system for buyers and sellers to easily communicate product information.

Our Classification and Procurement endpoints now accept UNSPSC codes at the family level, in addition to the existing support for ISIC, NACE, and MCC codes. With this addition, activities categorized using UNSPSC codes can easily map to EXIOBASE emission factors for streamlined emission calculations.

ISO 27001 Certification, New trust report

After months of auditing processes, we are excited to announce our ISO 27001 certification, following the international gold standard for information security management. This certification validates our adherence to global information security standards and reiterates our commitment to trust and credibility with our customers and partners.

You can find the Climatiq trust report here - a transparent resource for our certifications, documents, security procedures, and monitoring.

Data releases

New data versions 4.4 and 5.5, including:

  • BEIS: activity-based emission factors added for 2023 covering multiple sectors in the UK, in addition to new worldwide factors covering the Accommodation and Transport sectors
  • BEIS: the latest spend-based dataset has been added - valid from 2020
  • UNFCCC: Electricity supplier mix data for Canada for the year 2023 have been added
  • UNECE: Global emission factors for nuclear fuel consumption and renewables have been added - primarily to the Energy endpoints

Other improvements and fixes

  • The Quantis and GHG Protocol Scope 3 Evaluator dataset is removed from our database since the tool is no longer available 
  • "custom activities" and "custom activity mapping" have been renamed to "custom mapping" for clarity and to avoid confusion with "private emission factors." Docs and API URLs are updated; old URLs are still functional
  • Activity units for Climate Trace coal mining emission factors have been corrected

Energy endpoints 

  • Our Electricity endpoint now supports named electricity suppliers in the US 
  • Improved error messages to explain which regions and named suppliers are covered
  • Nuclear energy is now supported

Cloud Computing endpoints

  • All Cloud Computing endpoints are now out of alpha
  • AWS regions updated for ap_southeast_3 and eu_central_2
  • Cloud regions relying on AIB emission factors now use production mix for more accurate emission results. This will lead to varied CO2e numbers for certain regions
  • An optional year parameter now lets users indicate their usage year. We will select the closest emission factor to that year
  • There is now more flexibility with the accepted user-inputs for regions. For instance, EU CENTRAL 2, eu-central-2, and eu_central_2 are now considered equivalent. This helps integration, particularly with inconsistent region casing in services like Azure billing exports
August 9, 2023

New unified Energy endpoint, data version 3.3 including Climate TRACE, WRAP, and EPA ‘23, and more

Unified toolkit for energy emissions: calculate scope 1, 2, and 3.3 (FERA) 

Our new Energy feature provides the most comprehensive solution for automating complex carbon calculations for consumed energy - delivered through an easy-to-use API. Covering all three GHG emission scopes in line with the GHG Protocol and SBTi requirements, our solution offers calculation endpoints for used electricity, heat, steam, and fuel combustion. This enables users to understand and report the total impact of their energy consumption through a reliable toolkit and transparent methodology.

The electricity endpoint supports both market- and location-based methodologies, equipping users with everything they need to calculate electricity-related emissions with unmatched accuracy. It incorporates emission factors for over 120 global regions including local factors in the United States and Canada for true worldwide coverage. Moreover, users can leverage provider-specific factors from electric utilities in the UK (and soon the US) in line with the market-based method. Renewable Energy Certificates (RECs) can also be specified and automatically allocated for enhanced precision.

Additional support for scope 3.3 Fuel and Energy-Related Activity (FERA) calculations allows users to integrate upstream energy-related emissions, ensuring a thorough capture of indirect carbon footprints beyond just direct operations. This includes Well-to-tank (WTT) emissions originating from the production of fuel used to generate electricity, heat, cooling, or steam. It also accounts for Transportation and Distribution (T&D) emissions, capturing losses from the point of generation to the point of consumption. Finally, the WTT of T&D is integrated as well, considering emissions from the production of fuel associated with T&D losses. 

Read our Energy scope 2 and scope 3 guides to learn more about our methodologies, and refer to our API documentation for implementation details.

Note that this feature is a paid add-on - please get in touch if you'd like to trial or learn more about this feature.

New data partnerships: Climate TRACE and WRAP

We’re excited to announce the integration of Climate TRACE emission factors into our dataset, further enhancing the precision of our carbon calculations. Climate TRACE is a nonprofit that combines AI, data from 300 satellites, and remote sensing sources to construct the world’s first comprehensive record of GHG emissions based mainly on direct observation. Using this approach, Climate TRACE provides critical emission factors that were previously unavailable, filling in data gaps to bolster our solution and empower Climatiq users to achieve unmatched calculation accuracy. This new data covers categories such as fuel, building materials, mined materials, and metals across several countries worldwide.

Also included in our latest data release are over 600 scope 3 food and drink related emission factors sourced from the Waste & Resources Action Programme (WRAP). WRAP, a renowned climate action NGO aims to assist Food and Drink businesses in reducing waste, fostering sustainable product development, and optimizing resource efficiency. This addition provides extensive coverage for the UK, complemented by select global factors to enable businesses in the food and drink sector to measure and track progress in reducing supply chain emissions.

Thanks to these data partnerships, we are extending our solutions to include more sectors and applications, reaffirming our commitment to comprehensive global coverage and granularity of scientific data.

Data releases

We’ve released a new data version - 3.3 which includes:

  • Climate TRACE global emission factors for fuel, building materials, mined materials, and metals
  • WRAP scope 3 food and drink emission factors
  • EPA 2023 activity-based data
  • AIB 2023 electricity data for European countries
  • Green-e electricity residual mix data, covering the US eGRID subregions
  • EEI electricity supplier and residual mix data for specific suppliers in the US

Other improvements and fixes

  • New guide: How to List Metadata and Refine Searches
  • Freight & Shipping: Clarified how to query for locations in China in the documentation
  • Procurement: Improved documentation for selecting spend region
  • Estimates screen has been removed from the developer dashboard

For those who are still using legacy versions of our API, this is a friendly reminder to migrate to Beta4 now to access the latest capabilities. Older versions will be deprecated soon.

Read our Beta4 migration guide here.

July 5, 2023

Procurement endpoint live, new data version, API consumption reporting, new guides, 130+ Azure VM instance types added, “year released” added for emission factors

Streamline Scope 3.1 calculations: transform your spend data into accurate carbon footprint calculations

We are excited to announce the launch of our Procurement endpoint, specifically designed to provide advanced Scope 3.1 carbon footprint assessments. This new endpoint eliminates the complexity associated with spend-based calculations in accordance with EXIOBASE. It automatically determines basic prices by deducting trade, tax, and transport margins, specific to each country and sector. In addition, the endpoint provides automated currency conversions and inflation adjustments based on sector-specific inflation data from the European Central Bank, and country-specific rates provided by the World Bank to produce reliable calculations with little effort.

With flexible query options, including ISIC and NACE industry codes (support for UNSPSC codes coming soon) and Climatiq activity IDs, users have the ability to analyze data for a wide range of scenarios. In addition, custom margins can be provided to further enhance the accuracy and precision of calculations.

We collaborated with Prof. Richard Wood, a key developer of EXIOBASE, to design this endpoint. Prof. Wood is a member of our Scientific Advisory Board, where he provides important guidance to support the development of our solutions.

Learn how to get started with the Procurement endpoint through our handy guide here, and refer to our API documentation for implementation details.

Note that this feature is a paid add-on - please get in touch if you'd like to trial or learn more about this feature.

Track your API usage and subscription details 

New API usage and subscription plan screens have been added to your dashboard. You can now track the number of monthly API calls made, together with a detailed breakdown for each endpoint so that you can monitor your consumption and manage your account limits. Additionally, you can review add-on features activated for your account and request access to additional capabilities.

Other improvements and fixes

  • Our Postman collection has been updated to work with Beta4
  • New data source pages added to Explorer - example ecoinvent, BEIS
  • Batch estimations now available for VM Instances
  • Resolved Intermodal Freight API issues:
    - Error on addresses in Kosovo
    - Errors on Chinese road routing
    - Fallback to GCD (Great Circle Distance) on rail routing for destinations close to Norway or Sicily

Data releases

  • We released a new data version - 2.2: you can find the details here
  • We've added over 130 VM instance types for our Azure VM endpoint, including:
    - The Av2 standard series
    - The B series burstable
    - Several D-series, such as Dav4 and Das4
    - The Edsv5 E-series
    - The NV Series
    - All constrained vCPU capable instance types, which are identical to other instance types, but with fewer vCPU cores
  • “Year released” disclosure for emission factors
    - You can now view the "Year released" for emission factors in the Data Explorer
    - The /search endpoint now returns year_released information
  • The data releases now include a release date in the documentation. Beta4 also includes a release date for the "new features" document.

May 10, 2023

New API version, data versioning, AR6 emission calculations, audit trail, & more

Added: API version, data versioning, AR6 calculation method, audit_trail feature, ‘year’ logic, add-on endpoints, /unit-types endpoint, construction materials embodied emission factors

Updated: data quality flags, currency rates, data explorer, cloud computing endpoint, selector specification, improved factors, unit_type string categorisation

After a short break for easter egg hunting, we’re back with a major update, including a new API version (Beta4), data versioning capability, new logic for handling years, the AR6 calculation method, and many other changes & improvements. Here are a few of the major highlights.

Shiny new API version: hello Beta4

We are excited to introduce Beta4, our latest API version, featuring improved performance and new capabilities. Upgrade your implementation now to get access to the latest enhancements. More details about the new features can be found below. 

We recommend migrating to the new API version promptly, as older versions will no longer be supported and will soon be deprecated. If you are a Developer or Enterprise plan customer, please contact us if you require any assistance. 

For all API updates, including breaking changes and specific migration instructions please see our migration guide.

Introducing data versioning

The database underpinning Climatiq is frequently updated. New emission factors are regularly added, and existing factors are modified for various reasons, such as when a source publishes errata, new data quality flags are applied to existing emission factors, or when changes are made to a factor's metadata like activity_id or source_lca_activity value.

Updates like these often necessitate changes in your application. Therefore, we are now introducing the concept of data versioning, which allows you to choose when to opt-in to such changes, providing greater control over emission factors and data quality used in your calculations.

Our data versioning approach ensures that users can maintain stability in their applications while still having the option to access the most recent and accurate data when needed.

Please note that data versioning only applies to /estimate and /batch endpoints that require users to provide an emission selector in the API request. Endpoints like Cloud Computing, Intermodal Freight, Flights, and other advanced calculation endpoints that do not require a selector, will be automatically updated with the latest data version without user involvement.

For a detailed explanation of these changes and their implications, please refer to our data versioning guide.

New emission calculation method: AR6

This past March, the IPCC published their Sixth Assessment Report covering Climate Change in 2023. Throughout almost 8,000 pages, the AR6 goes into detail on the deep impacts we’re seeing as a result of rising greenhouse gas (GHG) emissions. 

They’ve also included an updated calculation method, which we’ve added as a default for sources that provide AR6 data. For information on calculation methods, see our co2e calculation documentation.

Introducing audit trails for advanced endpoints 

This update introduces customisable audit trails for calculations, which are invaluable for audit tracing and reporting compliance. Audit trails are used with our advanced endpoints, such as freight shipping, cloud computing, and classification.

Users can now control the visibility of these trails, enabling them for audit or record-keeping purposes. By default, audit trails will be turned off. If you're a user of these advanced endpoints and would like to access this capability, please contact us for more information.

Improved year handling for emission factors

We have implemented a new logic for handling years in emission factors. Previously, the year attribute corresponded to the publication year of the data source. Now, it accurately represents the year the data source deems most valid for the emission factor. 

Updated default data quality flags for enhanced accuracy

We’ve made changes to how we handle data quality flags in our calculations to align with current best practices and enhance the overall data quality. We kept the old default flags for those who still use them, but we have now introduced a new method. 

Going forward, we won’t include emission factors flagged for certain types of data quality issues in calculations unless the user specifies them in the API request. For which data quality flags have been affected, see our beta4 migration guide.

Add-on endpoints

Our Cloud Computing, Classifications and Custom Activities endpoints are now available as add-ons as part of our paid Developer or Enterprise plans, much like our Intermodal Freight endpoint. Please contact us if you are interested in using these features. 

New currency exchange source for spend-based calculations

We have switched our source for monetary exchange rates to the UN treasury, improving the accuracy and reliability of our currency exchange data. As a result, you will see some changes in the CO2e currency-related endpoints as the new rates are implemented.

Updated Data Explorer

We’ve revamped our data explorer homepage to make it easier for you to find relevant emission factors. You can now access emission factors by featured sectors and categories directly from the new homepage, as well as see the most popular factors in our database.

We’ve also added new pages for individual activities and emission factors. These pages display in-depth information about our data at-a-glance.

Data Releases

See the full data release log here.

  • Added 500 embodied carbon emission factors for the most common building construction materials from the Circular Ecology ICE Database, derived from EPDs.
  • Improved usability of emission factor selectors by streamlining electricity activity_ids, correcting typos and activity units, reevaluating data quality flags and LCA activities, rectifying release year and scope, updating source links, and correcting location-related errors in Azure cloud computing data.

March 24, 2023

GLEC-certified Intermodal Freight Shipping endpoint, location-specific electricity-aware Cloud Computing, Data Explorer improvements, Unit Types, and new data releases

GLEC-certified Intermodal Freight Shipping API endpoint

We are proud to announce that our Freight Transport API endpoint has achieved GLEC (Global Logistics Emissions Council) certification! As a globally recognised standard, GLEC ensures precise and consistent calculations of logistics emissions across supply chains. With this accreditation, you can confidently rely on the results from Climatiq's calculation engine for accurate, reliable results, suitable for audits, reports, and sharing with third parties—increasing their impact both within and beyond your organisation.

We've also created a video guide to assist you in getting started. Check it out here:

Region-based electricity data integrated into Cloud Computing endpoints

We've enhanced our cloud storage, cpu, and memory endpoints by incorporating location-specific electricity data for more precise calculations. These endpoints now utilise region-specific electricity emission factors for each data centre, instead of basing emissions solely on storage, CPU, or memory consumption. For added customisation, you can also override the power usage effectiveness and the emission factor used, giving you even more control..

Data Explorer improvements

We've added new pages for each sector, category, and region on the Data Explorer to make browsing related factors easier and give you a better understanding of the data available. Here are some examples: 

As our dataset continues to expand, we'll be introducing additional pages in the coming weeks to cover every aspect of the data.

Source dataset information now available for emission factors

The new source_dataset field has been added to all emission factors, now available alongside the source field in endpoints. This enhancement simplifies the identification and querying of specific datasets you're interested in, particularly when sources release multiple datasets.

In addition, we've added a new endpoint: emission-factors/source-dataset to help you explore the datasets issued by the sources available in Climatiq.

Other improvements

Data releases

We have a number of new datasets and updates for you:

  • All ecoinvent emission factors now have activity_ids, with some changes to categories and names.
  • Added EPA Fuel Emission Factors for 2019 and 2020: EPA Fuel EFs
  • Added UK domestic electricity supplier emission factors: Electricity EFs
  • Added BEIS Fuel Emission Factors for specific activity_id: activity_id fuel_type_natural_gas_gross-fuel_use_na for years 2016-2020: Natural gas EFs
February 23, 2023

Credit card transactions, all new cloud compute endpoint and improvements in automatic mapping

Calculate emissions from credit card spend

In addition to industry codes ISIC and NACE, we are now able to provide estimates based on Merchant Category Codes (MCCs), which are used to classify financial transactions globally. Simply hand up the code and the amount spent and a footprint will be provided for anywhere in the world and in most major currencies.


All-new cloud compute endpoint including embodied and dynamic power usage calculations

We’ve released a new computing endpoint, where you can input a specific virtual machine instance you’re renting, and get back a combined estimate for both the emissions and electricity consumption for the memory and cpu used, and also an embodied emissions for the underlying hardware.

GCP, AWS and Azure are supported with default values. If you have more details from your cloud provider, you can provide custom details such as average vCPU utilisation (load), specific power utilization efficiency (PUE) or electricity emissions factor (either from the Climatiq dataset or one uploaded by you).

Note that this feature is in alpha and therefore subject to change. Please do get in touch if you'd like to learn more about the feature.

Screenshot 2023-02-22 at 10.16.32

Automated mapping tool now accepts data by API

Our custom activity mapper can now accept your taxonomy via an API endpoint. This allows you to send your (or your clients') internal categorisation to our activity mapping dashboard, where you can then view suggestions to map these labels to Climatiq activity IDs.

Self-reported emission factors now supported

We have added a "self-reported" flag, both as part of our updated compute endpoint above (for example we have included Google's electricity emission factors for use in estimating cloud emissions), and to pave the way for increasingly granular emission factors provided directly from companies - particularly useful for supply-chain assessment. If there is any particular data you would like to see (or to disclose your company’s data in our database) please get in touch.

Please note that emission factors with this flag will not be used in API responses by default due to their nature of the emission factor; these will need to be explicitly allowed to appear in requests using the allowed_data_quality_flags parameter.

Other improvements and fixes

  • With encouragement from the Smart Freight Centre (the team behind the GLEC Framework), Radiative Forcing Index (RFI) of 2 is now being applied by default to all air legs of our intermodal transportation endpoint, meaning that the full impact of aviation on climate is better accounted for; this can be removed if required for specific reporting requirements.
  • New data field alert! Estimates from all our endpoints now include the name of the emission factor in addition to the uuid and activity_id.
  • Filters in the Data Explorer have been improved and streamlined - all your filters are now in one place and include the ability to filter to different license types.
  • The data explorer is now part of the experience of your Climatiq account.

Data releases

We have released a number of new datasets and updates, including:

  • EPA spend-based factors for 2018
  • Australian electricity emission factors from DISER for 2022
  • Hong Kong electricity emission factors from HKEI and CLP Group for 2019, 2020, 2021
  • EU electricity emission factors for 2021 from the EEA.
  • Google for Google Cloud Platform data center regions for 2021
  • IPCC Land-Use - N2O emissions from managed soils including synthetic and organic fertilizer applications 
  • Emission factors from the GHG Protocol beta tool have been marked with a methodological flag as they are no longer hosted by the GHGP and we have found numerous errors in conversion from the original sources (which we host directly) 

February 3, 2023

Automated logistics endpoint live, data explorer/search overhaul, electricity factors explained, Postman collection

Automated freight transport emissions endpoint live! 🚆⛴️🚚✈️

After running the alpha through a thorough testing program, including hundreds of thousands of real-world tests in numerous client implementations, the intermodal logistics endpoint is ready for prime-time. It's fast and powerful, allowing you to get GLEC-compliant emission estimates broken down by leg and by use-phase and upstream emissions. Just provide two locations on the globe, a cargo weight and nominate a form of travel. The rest - from plotting routes to selection of most likely ports to electing GLEC-compliant emission factors - is done for you.

But that's not the end of the story; while the endpoint can give you a valid, fully transparent answer from minimal inputs, it can also accept a huge amount of more granular data as well: cargo types (e.g. chilled or unchilled), vehicle types (e.g. van or heavy goods vehicle), specific transport nodes for any given leg - all this and more can be accepted to provide ever-more accurate estimations. For an example of what it can do, check out the announcement with our partner Celonis

Note that this feature is a paid add-on to the standard API subscription - please do get in touch if you'd like to trial or learn more about the feature.

Example request and response to the intermodal endpoint

Data Explorer and search endpoint overhauled

We’ve given our Data Explorer an overhaul - emission factors are now grouped by their emission-generating activity, giving you more comprehensive search results over a range of activities when searching through the emission factors available in the API. In addition to this, our search algorithm has been completely revamped. While using the Data Explorer and the /search endpoint, you will see fewer, but much better results for any given query.

Demystifying electricity emission estimation

If you have ever attempted to assess emissions generated from electricity usage, you know it's not as straightforward as it might appear - there are a vast variety of emission factors and even more ways that they can or should be applied. So as a first step in helping people use the API to navigate their way through this, we have published a guide - the first in a series of guides on emission factor selection.

Other improvements and fixes

Data releases

We have released a number of new datasets and expanded the range of several more to cover either retrospective years or the latest up-to-date factors:

January 4, 2023

Activity mapping suggestions, embodied cloud computing factors and lots of new data

Activity mapping automatic suggestions [alpha]

The first iteration of our automatic activity mapping is here! This upgrades our activity mapping feature to provide suggestions as to what the appropriate Climatiq activity ID might be for your data. Simply add (singly or as a bulk upload) whatever labels you use for emission-releasing activities or consumption categories and then let our suggester find an ID to suit; in this first release you can filter results by source or unit type. Then simply accept the suggested activity ID  for each, or find alternatives via the explorer. Once mapped, you can hand up your custom-defined activity label along with the appropriate parameters (kg of material purchased, kWh consumed, kilometres travelled, amount spent etc) to our /custom-activity endpoint to get a valid estimation back. Then relax - you never need worry about mapping your activities or material categories again - unless you add more! You can create multiple different mappings - they are unique per project, simply make sure you are using an API key associated to the correct project when you perform estimations.

Note that this feature is in alpha and will see significant performance improvements soon. We welcome feedback - please do get in touch if you've got feedback or like to learn more about the feature, upcoming improvements and how you can incorporate it into your build.

Screenshot 2023-01-03 at 14.24.32

Embodied emission factors for cloud computing now available

Climatiq now provides another piece of the puzzle for assessing cloud-based infrastructure: the embodied emissions associated with the equipment used to run cloud services via Azure, GCP or AWS. These factors allow you to estimate the impact of these embodied emissions, expressed per CPU-hour so that you can attribute back to your usage just as can be done with the emissions associated with the usage of cloud infrastructure from these three providers.

Further data releases

We have released a number of new datasets and expanded the range of several more to cover either retrospective years or the latest up-to-date factors:

  • UK BEIS/Defra spend-based factors (2022 release, from 2019 data)
  • Climate Transparency electricity EFs for 2020, 2021, and 2022 (in addition to 2019)
  • AIB electricity factors for Europe, including production mix, residual mix, and total supply mix EFs from 2015 up to 2020 (in addition to already available 2021 and 2022 data)
  • GHG protocol facility data for estimating impact of owned (broken down into separate factors for scopes 1, 2 and 3) or leased (scope 3 only) facilities, based on global averages

Other fixes and improvements

  • Rail logistics distance calculation has moved from estimates to actual network distance for Europe, providing more accurate estimates for our intermodal logistics alpha.
  • Some GHG Protocol flags have been marked with the partial_factor data quality flag due to lacking non-CO2 emissions. If you’re explicitly filtering on data quality and using GHG Protocol you might want to update your queries
  • We fixed a bug whereby commas included in queries to the /search endpoint led to an empty list of results.
November 30, 2022

Intermodal freight launched, data quality improvements, code snippets

Intermodal logistics solution launched with Celonis

We are very pleased to announce the launch of the first live use-case of our intermodal freight/logistics endpoint with our design partner, Celonis. This endpoint is now supplying road, sea and air route determination and GLEC-compliant CO2e estimations globally, as well as rail routes in Europe, to a range of live implementations - please get in touch if you would like to trial.

Screenshot courtesy of Celonis.

Data quality now queryable, including new data quality flags

Two new data quality flags have been introduced: partial_factor to identify factors whose CO2e value represents only part of the emissions (typically CO2 only) and suspicious_homogeneity to highlight where we have detected potential boundary issues in the presentation of several factors. These and the existing flags can now be included in queries, allowing you to filter them in or out using a new allowed_data_quality_flags selector. Some flags are allowed by default in your queries to avoid backward compatibility issues. We recommend you read the data quality guide and the API reference and determine what sort of data quality issues you’re okay with accepting in your estimates; you will also see these flags highlighted and explained in the Data Explorer

Code snippets live in the Data Explorer

You may have noticed that things are being updated in the Data Explorer. This month we have released a number of tweaks to help browse emission factors and make understanding and performing API calls even easier. The most obvious is the new code snippets which are now present in each emission factor - simply click on the tab at the bottom of the factor and you can see exactly how to make an estimate using curl, including both request and response (with appropriate selectors and sample parameters).

Other fixes and improvements

  • Two key datasets are now live with electricity factors: EEA 1990 - 2020 and ecoinvent v3.8.
  • BEIS historical EFs for natural gas, electricity grid mix and water supply and treatment were added for the years 2016-2020.
  • A change to rounding means small changes to many factors.
  • Previous EPA spend-based dataset has been updated with constituent gases.
  • A number of factors have had their data quality flags reviewed.
  • Query error handling improvements - when the search endpoint is called with a typographical error or an unknown field it will throw an error instead of silently ignoring the field.
November 3, 2022

ecoinvent now searchable, batch actions for activity mapping and computing

ecoinvent live in the Data Explorer

A little while ago we announced our partnership with ecoinvent, one of the world's most comprehensive environmental datasets. These data now live in the Data Explorer right alongside the rest of the sources available in Climatiq. Note that access to ecoinvent data requires a paid license - get in touch with us if you like to know more about key environmental datasets like ecoinvent.

Batch uploading for activity mapping

Our activity mapping tool now allows batch uploading, meaning you can add a full schema of custom activity labels mapped to Climatiq activity_ids in one go, and start making calls based on your own taxonomy. Stay tuned for more updates to our mapping capabilities, as we are working hard to develop some great new the tricky task of mapping activity data to emission factors.

Computing endpoint: batch estimates added and metadata endpoint out of alpha

We now have batch endpoints for the different compute endpoints including memory, CPU and storage. This is handy if you need to perform many computations at once. In other computing endpoint news, the computing metadata endpoint is now out of alpha - you can rely on it being stable between versions now.

Other fixes and improvements

  • Sea routes now follow actual global trade lanes and we've added basic rail estimates for Europe in our intermodal freight alpha (contact us to trial).
  • We have fixed some bugs where endpoints did not accept activity_id as a parameter. activity_id should now work properly for all endpoints.
  • We have updated our underlying UN/LOCODE data, resulting in some locations being more accurate.
October 5, 2022

Data quality flags, intermodal flights

Data quality flags now live in the Data Explorer

We're very pleased to announce that the excellent work our science team do week in, week out is now front and centre in the Data Explorer! Where we have detected a data anomaly, there will now be an alert displayed and an explainer to tell you more about the issue found. Of course, these flags are available in the API so you can listen for them in your implementation.

Screenshot 2022-10-03 at 20.24.35

Flights added to intermodal transport

Our GLEC-compliant freight endpoint (currently in alpha) is now able to route-plan intermodal logistics for road, sea and air. Just put in a geolocation (long/lat, postcode, city name, full address, or just a search query) and select your mode and let the endpoint do the rest. It will plot the route to the nearest port or airport and provide emissions estimates broken down by each leg, including scope 1 and 3 emissions. Just let us know if you'd like to join the alpha.

LCA documentation improvement

We're constantly improving our documentation based on your feedback - and after a few calls with users to understand how we can better describe the way LCA activity is handled by the API, we've updated our how-to guide.

September 8, 2022

ecoinvent data, intermodal freight alpha, private data guide and more

  • ecoinvent data to be available via the API - a very exciting data partnership!
  • Our GLEC-compliant intermodal freight emissions endpoint is going into alpha.
  • Good news for those estimating cloud computing impacts - nearly 700 new and updated factors for Azure, GCP and AWS.
  • AIB 2022 data for the national electricity grid factors for European nations.
  • Private emission factors guide released, showing step-by-step how to upload emission factors to use in your API instance.
  • Some major performance improvements to API response times.

Data partnership announcement - ecoinvent

You never go very far in the world of emissions assessment without hearing the term "ecoinvent". We've been working with the ecoinvent team to make the huge array of emission factors in their v3.8 dataset available to you via Climatiq's lightning-fast, distributed infrastructure so that you can embed the world's most widely-used materials/life-cycle emissions dataset right into the heart of your decision-making. You will be able to browse the dataset soon via our data explorer; in the meantime, just get in touch with us if you are interested in getting these data into your project.

GLEC-compliant freight estimations (alpha)

Those familiar with our flights endpoint already know that it's fantastically helpful to have distance calculations taken care of. Now we're very pleased to be going into alpha with an intermodal version that will estimate road and sea freight emissions from and to any location in the world - whether you have coordinate, city name, postcode or any other type of address or location information. Compliant with the Global Logistics Emissions Council and, logistics movements are estimated in realtime incorporating factors such as traffic data, allowable routes, vehicle/vessel size, road gradient and plenty more. Please get in touch if you are interested in joining the alpha group trialling this new functionality.

Updated cloud computing and AIB EFs for 2022

Cloud Carbon Footprint (CCF) have released data for 2022 and we've now transformed this into nearly 700 emission factors to help bring your cloud computing measurements bang up to date.

The AIB has also released their 2022 national electricity grid factors for European nations.

Other important updates

  • We've released a handy how-to guide to step you through uploading private emission factors to be used in the API right alongside the other datasets available.
  • The flights endpoint now incorporates emission factors from GLEC. If a GLEC emission factor is a better fit than some of the existing ones, that factor will be picked instead.
  • We’ve made some major performance improvements. You should see the API work significantly faster now - calls to /estimate should respond as quickly as 20ms on a hot connection

Errata / notifications

  • In adding the latest AIB emission factors, it was highlighted that AIB label their factors based on the year calculated rather than the year published. For consistency across sources we will use the year published, which means that the AIB factors previously labelled as year 2020 have been updated to 2021; the new EFs are labelled 2022.
  • New data is now no longer appearing in the deprecated /emission-factors endpoint - if you haven't already, please do migrate to the /search endpoint.

August 4, 2022

Private emission factors, GLEC, BEIS 2022

  • Private emission factors - a new add-on allowing you to easily upload any factors you have licensed or supplied so they can be available through the Climatiq API.
  • Global Logistics Emission Council (GLEC) Framework emission factors now available.
  • UK BEIS 2022 emission factors, including new homeworking emission factors.
  • Lots of helpful new functionality across our endpoints - details below!

Private emission factors

Many of you have told us that while the datasets available in the API meet the majority 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. So we're very pleased to announce a new feature, available as an add-on to our Corporate or Commercial tier: Private Emission Factors. 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. Contact us for more information on getting access to this feature.

Screenshot 2022-08-03 at 14.52.26

GLEC Framework now supported

We're delighted to announce that the default emission factors from the Global Logistics Emission Council (GLEC) Framework are now available via the Climatiq API. These are ready to use in your freight logistics estimations from today. Stay tuned for more on this front, as logistics is going to be a big focus for the next few months (grab me or one of the team if you want to learn more).

BEIS 2022 data now available

Here they are! Note that, as with any annual data update, any queries that are not specifically calling 2021 will automatically update to use 2022 data. As well as updating their existing factors based on the latest data available, BEIS have for the first time included emission factors for estimating homeworking emissions.

Other important updates

  • With the release of private factors, a new access_type field has been added to API responses, which will tell you whether a factor is from the public set of emissions factors or from your private store.
  • Each emission factor now has a unique ID that you can use to identify a specific emission factor. You can use uuid when estimating, or when searching for emission factors, and will also receive a uuid field back in API responses.
  • To avoid confusion, the previous id field has been renamed activity_id, to reflect the fact that these structured IDs are map to an activity, not a specific emission factor. The API will continue to accept id for queries, so no existing queries should break; he API also currently returns both id and activity_id in the responses. The two fields are always identical, so if you rely on the id field your existing logic should not break. We suggest migrating away from id to activity_id both in your queries and in your response-handling logic when you are able.
  • Several endpoints are out of alpha, meaning we will not change the API surface in a backward-incompatible way, including cloud compute /cpu, /storage and /memory (calculating cloud computing emissions), /classification (mapping industry codes to emission factors), /custom-activities (allowing user-defined variables in place of activity_ids) and /flights (calculating emissions for air travel and freight based on airport codes).
  • A new cloud /compute endpoint has been added (in alpha), which lists the supported cloud providers and the regions they are available.
  • You can now filter on unit types in the /search endpoint, and a dedicated endpoint to list unit types has been added.
  • You can now use wildcards (*) at the end of activity_id and region in the /search endpoint, if you need to perform queries across multiple activity IDs or subregions.

Errata / notifications

  • While updating to the latest BEIS 2022 values, it became clear that previous BEIS datasets expressed CH4 and N2O emissions in kgCO2e rather than kgCH4 or kgN2O as other sources do, although they were not labelled as such. Please be aware that these values will be correctly expressed in the 2022 dataset and that we will be updating them in the 2021 dataset in the coming weeks (this won't affect standard emission estimates, as these are based on overall CO2e calculated by the source, which will not change).
  • We will be adding the latest AIB emission factors soon, which has highlighted that AIB label their factors based on the year calculated rather than the year published. For consistency across sources we will use the year published, which will mean that AIB factors currently labelled as year 2020 will be updated to 2021; the new EFs will be labelled 2022.
  • This will be the last time new data will appear in the deprecated /emission-factors endpoint - if you haven't already, please do migrate to the /search endpoint.

June 30, 2022

Region fallbacks, data quality flags

Automated region selection

You can now specify a region_fallback boolean for the custom activity, classification and estimate endpoints selector. If this boolean is set to true and your initial estimate fails to find an emission factor specific to the country or region provided, Climatiq will automatically broaden your region to factors with the same ID mapped to regions the country falls within (for example Tanzania → Africa → Global) until it finds a compatible emission factor.

Data quality flags

Data quality issues found by our science and data team are now highlighted within API responses. Climatiq has a tiered approach to handling of data quality issues; where emission factors are considered statistical outliers or otherwise seriously problematic, they are not included in the API. However, where the issues are less serious we include the datapoints to provide consistency with the source data, and provide a data_quality_flags in the response. Current flags are erroneous_calculation and notable_methodological_variance;  details about the issues detected will be outlined in the description field of the emission factor in question. More details about this feature can be found in our how-to guide and in the data guidance of the OEFDB.

Screenshot 2022-06-29 at 23.09.38

How-to guide page refresh and new guides

Speaking of how-to guides, we've overhauled our guides page with a new look and feel and added a couple of new guides in addition to the data quality guide above:

  • A currency guide outlines which are available through Climatiq and how currencies conversions are handled.
  • A guide for how to use Climatiq with Python, featuring example Jupyter notebooks with a number of functions including how to query EFs based on industry classification codes

Data Explorer improvements

The data explorer has been updated to make it even easier to find the emission factor you need, with an update to filters allowing for selection of multiple categories at a time and regions now returning any sub-region of a country that you have filtered to (for example all US states will be returned if you filter to US rather than just US-wide factors).

Other important updates

  • In the computing endpoint you can now provide cpu_count as a float instead of an integer, if you are working with an environment where it makes sense talking about 1.5 or 0.5 cores instead of whole increments.
  • Better error messages in scenarios where you provide an invalid parameter. Where previously the query would failover to the default unit for an emission factor, this will now surface an error. Note that this might mean that API calls that were previously silently wrong will now provoke an explicit error from the API.
  • API calls using the wrong method now also returns a JSON body, rather than just a status code 405 and an empty body.
  • The custom activity mapping tool, available in the dashboard to enable activity mapping via the custom activity endpoint, now accepts a broader range of characters.
  • Unit change alert - room-night is now supported - note that previously BEIS Hotel Stay EFs were wrongly listed with person-night as their unit. If you are not already, please make sure your calls are expressed in room-nights as per BEIS guidance.

May 26, 2022

Stripe app launch and 12,000+ emission factors

After having to keep things very hush-hush we can now officially announce that Climatiq is one of just 50 launch apps on Stripe's brand new App Marketplace (announced 24th May). Our Emissions Calculator app allows any stripe merchant to assess the impact of every sale (and their entire sales history) based on GHG Protocol and EPA emission factors. We're very excited to be helping Stripe merchants understand their impact, as well as prompt action through Stripe's carbon removal fund.

68747470733a2f2f66696c65732e7374726970652e636f6d2f6c696e6b732f4d44423859574e6a644638785331565a4d7a4a4d63484236656a4a755a32524d66475a7358327870646d5666624564774d6c46585247354956546c33636c56465258526162574e746332647030307a384d7174494 (3)

As well as this, we now support over 30 currencies, which will be converted in real-time for spend-based emission estimates.

We also released a number of improvements to our API error handling, including better descriptions of errors to help you understand what might have gone wrong.

Reminder: remember to cut over to the new search endpoint if you haven't already - we will soon be deprecating the emission factors endpoint to provide a much lighter (and more sustainable!) way of assessing the availability of factors.

Data updates:

...all of which takes us past 12,000 datapoints!🚀

April 14, 2022

Custom activity mapping, industry codes and 4900+ emission factors

We have added the ability to map your own custom taxonomies to Climatiq emission factors right in our dashboard. Just click on the Activity Mapping tool in the dashboard and once you have mapped your taxonomy to emission factor IDs, the custom activities endpoint will accept your own IDs as selectors in API calls. You can have different maps for each of your projects, giving you plenty of flexibility.

Screenshot 2022-04-13 at 17.28.59

A new classifications endpoint has in now in alpha. This endpoint allows you to hand up industry codes (in this first release ISIC4 and NACE2) to the API, meaning activities can be automatically classified and estimated. In addition, as these codes map to each other via the UN correspondence tables, factors that aren't directly mapped to the code passed up can be automatically selected to ensure the most valid estimates are returned. There'll be more classifications to come soon, including NAICS and CPC, making it increasingly easy to get the best emission factor automatically - please do get in touch if there is a particular classification you would be interested in seeing supported.

The new search endpoint was released to replace the deprecated list emission factors endpoint to provide a much lighter way of assessing the availability of factors (please do move to the search endpoint if you are still using the list factors endpoint).

Data updates:

  • The full set of UK BEIS/Defra emission factors is now available, including full coverage of constituent gases across all categories.
  • US and UK EXIOBASE spend-based emission factors are now live - the rest of the 44 economies and 5 “rest of world” regions covered will follow soon, along with some new data quality features.

March 21, 2022

New cloud computing endpoint and 3500+ emission factors

Since our last release notes we have:

  • Released a cloud computing endpoint into alpha. Try it out to estimate emissions incurred by your cloud computing usage.
  • Improved the flights endpoint logic to cascade through a greater range of emission factors based on the region, flight class and distance supplied in the query.
  • Enabled querying our emission factor endpoint by LCA activity. We’ve also made some changes to how we provide LCA values to better represent the underlying data. If you were querying on the old values explicitly, you might need to update your queries - see our how-to guide on LCA here.
  • Added a bunch of great new data data (taking us past 3,500 emission factors!) including:
    - Our first ingress of EXIOBASE spend-based emission factors - for Germany! There will be lots more coming, covering 44 economies and 5 “rest of world” regions.
    - The full set of EPA 2021 and eGrid 2022 (our first set of 2022 factors), with constituent gases.
    - Global electricity factors used by the GHG Protocol scope 3 evaluator
  • Improved error messages to provide more information when there is an issue with a query.
  • The data explorer has had an upgrade, with search accuracy and response times  improved, as well as some improvements in display of emission factor details.
  • Updated the dashboard to reflect more clearly your activity and to pave the way for more improvements (coming soon!)
  • Fixed a bug whereby our alpha endpoints weren’t recording data to the dashboard
February 14, 2022

Climatiq Beta3 release

Only rarely do we ship "versioned" releases, preferring to release continuously to prioritise getting our data and tools into your hands. However in this instance we have a range of exciting updates which involved the potential to break or interfere with existing implementations. Before we get to the details of the release, it's worth mentioning that we have published a handy migration guide to step you through switching from v2 to v3 - and don't worry, v2 will remain supported while you do. We intend for this to be the last beta release before we go into full production.

On to the release details (available in full with more info in the release blog). In Beta v3 we have:

  • Added support for individual GHGs as well as total CO2e. Responses from the ´/estimate´ endpoint now returns a ´constituent_gases´ object, which provides - where available - both the total CO2e as well as each of the constituent GHGs that an activity emits.
  • Added support for multiple methods of CO2e calculation, based on different conversion methodologies provided by the IPCC in their 4th and 5th Assessment Reports. The ´/estimate endpoint´ will return ´co2e_calculation_origin´ that will either be Climatiq or the source depending on whether the source provided a ´co2e´ or Climatiq has calculated it. Learn more about the provision of CO2e and specific greenhouse gases here.
  • Added the full set of emission factors used by the GHG Protocol in their GHG Emissions Calculation Tool are now available via the Climatiq API, including CO2e expressed in 4th or 5th assessment report equivalencies as well as raw CO2, CH4 and NO2 emission factors.
  • Alongside this the latest spend-based emission factors from the GHG Protocol Scope 3 Evaluator are available (CO2e), joining existing US EPA and UK BEIS spend-based factors to provide a set of global metrics that can be used for supply chain assessment.
  • Added UK BEIS/Defra electricity transmission & distribution and both electricity and fuel well-to-tank-transfer (WTT) factors (CO2e)
  • Added two flights endpoints: ´travel/flights´ and ´freight/flights´. These intelligently calculate emissions for passenger or cargo transport, given an origin and destination - these replace the ´FlightDistance´ and ´WeightOverFlightDistance´ units which have been removed from the ´/estimate´ endpoint.
  • A number of updates have been made to units for accuracy and future-proofing - full details in the docs and in the blog.
  • Added full documentation of sources represented in the OEFDB, including licensing details.

There's a lot there, so plenty of additions have been made to the docs page to help take advantage of the new functionality, including as mentioned the handy migration guide (note you can switch back to the v2 docs page using the selector in the sidebar).

January 10, 2022

EPA spend-based emission factors and more

We hope you had a chance to take some time to reflect on the past 12 months and to revive as we go into a huge year for tackling the climate crisis - 2022 feels make-or-break.

Here at Climatiq, while we’ve relished the chance to take stock, we haven’t slowed; we’re starting 2022 with a bang by announcing the addition of almost 400 spend-based EPA emission factors to the API. Having a dry January? Why not find out how much carbon you’re saving - now according to data release by either the UK or the US government.

There’s a very serious side to this of course - assessing supply chain emissions is a huge problem for companies, and while spend-based data isn’t perfect, in many cases it’s the only viable way of reporting. As such, the UK and US data will soon be joined by the high-level global numbers used by the GHG Protocol scope 3 calculator.

Want to make sure these numbers are comparable? We’ve got you covered: the Climatiq API provides currency conversion on the fly, based on the average rate of the year the emission factor was reported.

That’s not all of course - as ever, there’s a range of data and functionality additions since our last release communication, which you may already be using. In case you missed them:

Open Emission Factor Database (OEFDB) and data explorer:

  • 94 new building-related EFs from UK BEIS/Defra, including water, heat & steam refrigerants & fugitive gases
  • 394 spend-based EFs from the US EPA
  • An array of new sectors and categories to choose emission factors from - see our data explorer to discover more
  • Each factor in the database has been qualified with the lifecycle activity it applies to, based on the source methodology - this data is now available via the API (available in the data explorer soon!)
  • Speaking of the data explorer, you may have noticed you can now filter by unit type, that results are paginated and that if you right-click on an emission factor you can open a page which provides a view of just that emission factor.

API functionality and documentation:

  • Enabled CORS - meaning the API can now be used in client-side applications like WebApps.
  • Dynamic currency conversion has been added, meaning spend-based emissions can be calculated in any currency, based on the average conversion rate from the year the emission factor was calculated.
  • We’ve improved error handling and API responses to improve understanding of any issues encountered when making calls.
  • Our docs page now is more user-friendly, which more understandable headings and a better mobile experience
November 16, 2021

Climatiq Beta2 release

Led by feedback from you, our beta community, this release includes a bundle of exciting updates. There's lots of detail on what has been updated and why in our release blog post, but here are the key things to know. We've:

  • Launched the Data Explorer, a brand new application to explore and filter emission factors available in the API by any criteria.
  • Added batch processing to the API, allowing for parallel estimations.
  • Added querying of sources, years, categories, sectors and regions fields, allowing the determination of available values based on a given emission factor query.
  • Added Unit Types as API parameters, providing a modular approach to unit conversion per emission factor.
  • All responses now include factor and unit.
  • Launched a whole new API documentation page providing details as to how to take advantage of these features.
  • Performed a root-and-branch data review - led by our data and science team - of the underlying open database (the OEFDB), to provide standardised, machine-readable IDs, improved naming conventions and clearer descriptions and categorisation.

These updates represent a significant improvement in both technical usability and in data quality and robustness. Above all, it sets us up for fast iteration in both including new emission factor data (look out for spend-based scope 3 factors soon) and rapid development of features in the API.

To take advantage of the new features and dataset you will need to update your queries based on the new version of the implementation docs available at docs.climatiq.io (but don't worry we still support the old version, so nothing will break).

Stay up to date
Sign up for our newsletter