Travel v1 General Availability (GA)
Climatiq has released the first General Availability (GA) version of the Travel feature. There are few major changes from the preview versions, but moving to GA means Travel is now a core part of Climatiq, with all the backwards compatibility guarantees that this entails.
This document is the changelog & upgrade guide for the GA version. See our API versioning guide for how API versioning works at Climatiq. View the Travel API reference to get all the details, including request & response bodies.
The GA version of Travel is available at:
https://api.climatiq.io/travel/v1/The existing preview versions of Travel are now deprecated, and will be removed in January 2027.
Notable Changes
Removal of the spend-based endpoint
The spend-based endpoint has been removed. It relied on EXIOBASE factors from 2019, which are fairly old for accurate reporting, and spend is not a reliable proxy for travel emissions in the first place: a taxi and a rental car can vary widely in price, while their CO2e may be very similar.
We recommend using the distance-based and hotel endpoints, which are significantly more accurate.
If you only have spend-based data, we recommend using the Mapping Agent to find an appropriate emission factor for a given travel.
If you want to replicate the behavior of the old spend endpoint, you can use these EXIOBASE 2019 activity IDs in the Basic Estimate endpoint:
spend_type | EXIOBASE 2019 activity ID |
|---|---|
air | transport_services-type_air_transport_services |
road | transport_services-type_other_land_transportation_services |
rail | transport_services-type_railway_transportation_services |
sea | transport_services-type_route_type_inland_water_transportation_services |
hotel | restaurants_accommodation-type_hotel_restaurant_services |
Migrating from v1-preview3
Migration should be straightforward. As always, the reference documentation contains all the detailed API requests and responses.
- Change all URLs from
https://preview.api.climatiq.io/travel/v1-preview3/*tohttps://api.climatiq.io/travel/v1/*(note the removal of thepreviewpart in both the domain and the path). - The spend-based endpoint no longer exists. If you were using it, see Removal of the spend-based endpoint above for how to migrate.
The distance-based and hotel endpoints are otherwise unchanged.
Travel v1-preview3
This version of Travel is available at:
https://preview.api.climatiq.io/travel/v1-preview3/See the reference documentation for detailed API requests and responses.
Migrating from v1-preview2 to v1-preview3
Notable changes
- The
v1-preview3version of Travel has been updated to use the newest emission factors released from BEIS. Most notably this means that there are emission factors for e.g. car travel all the way up to 2025.
API Changes
No incompatible API schema changes were introduced. However, for flight classes, the premium_economy option was added.
Travel v1-preview2
This version of Travel is available at:
https://preview.api.climatiq.io/travel/v1-preview2/See the reference documentation for detailed API requests and responses.
Migrating from v1-preview1 to v1-preview2
Notable changes
- The
v1-preview2version of Travel has been updated to use the newly released Energy feature v1.1, this affects the results given from rail and car travel.
API Changes
No API schema changes were introduced. In order to start using the updated calculation methodology, you only need to update the URL used.