What's new in Climatiq

Latest features, enhancements and changelog
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; detailed release notes on GitHub here), 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