Freight v3.1

Climatiq has released a new version of the intermodal freight endpoint. This is the changelog & upgrade guide for that version. See our API versioning guide for how API versioning works at Climatiq.
We’re launching a new breaking version of our freight endpoint to comply with the latest version of the GLEC Framework (GLEC v3.2).
We will not backport the new GLEC v3.2 emissions factors to the freight v3 endpoint, to allow you to be in charge of when to adopt the new methdology.
Freight v3.1 is now Generally Available at https://api.climatiq.io/freight/v3.1/intermodal. Freight v3 is now deprecated and will continue to run for at least one year (until June 2027).
The changes needed in client applications to migrate from freight v3 are minimal.

Freight v3.1 (June 2026)

Freight v3.1 has been released to General Availability. The main API endpoint is now available at https://api.climatiq.io/freight/v3.1/intermodal.

Breaking changes from v3 to v3.1

There are no breaking changes between freight v3 and v3.1.

Migration from v3 to v3.1

Update your endpoint URL from https://api.climatiq.io/freight/v3/intermodal to https://api.climatiq.io/freight/v3.1/intermodal

The v3 endpoint remains available with the old data for backwards compatibility but is deprecated and will be removed in June 2027.

Notable changes

Notable changes in freight-v3.1 are:

Inclusion of GLEC-3.2 factors
Addition of fine-grained inputs for road transport in India
Addition of a rail emission factor for mixed propulsion in India

API Changes (Request)

The requests you send to the API should still look very familiar. If you’re using the default parameters for everything, your requests continue to work as-is. You can find the API documentation for freight v3.1 here.

Road Details in India

GLEC 3.2 added specific road emission factors for India. To select India-specific emission factors, you can provide an india object inside of the road_details section of leg_details to incorporate them. Have a look at the API reference documentation to learn about the possible parameter combinations.

If you are using road freight in India you should consider the new options available, otherwise your estimates will be made using our default vehicle details in India.

Methodological changes

There are no metholodical changes in freight v3.1 and all the emission factors used have been updated to the newest value provided by the GLEC organization.