Warning :
this endpoint is a beta version, input and output contracts might change.

This endpoint returns CO2e emissions (i.e CO2 equivalent emissions) in grams (g) for a historical route of a given vessel.
The historical route is searched between a port of origin (fromLocode) and a port of destination (toLocode) after a given date (leavesAfterDateTime or leavesAfter).
The CO2e calculation takes into account the actual speeds and distances (inside and outside ECA zones) of the vessel during its historical journey and guarantees accurate results.

Vessel information

The vessel can be identified either by its imo number or its mmsi. In the case both are given, the mmsi will be taken into account.
We only support CO2e calculation for container vessels.
We use the engine characteristics of the vessel to compute precise CO2e emissions. If we cannnot find enough data on the IMO you passed as a parameter, we apply GLEC Emission Factors.

Origin, destination and date.

This endpoint takes two UNLOCODE port locations (fromLocode and toLocode, both required) and a date (leavesAfterDateTime (ISO 8601 format) or leavesAfter (unix time is milliseconds)).

Cargo specifications (container only)

We provide CO2 calculation for FCL and LCL. We support dry and reefer container types (containerSizeTypeCode).
The following types are supported by our API :
20GP or 22G1 (20ft, General purpose (Standard)) [Default]
40GP or 42G1 (40ft, General purpose (Standard)),
40HC or 45G1 (40ft High cube, General Purpose),
22R1 (20ft, Reefer),
40NOR or 42R1 (40ft, Reefer),
40REHC or 45R1 (40ft High cube, Reefer)

Here are common use cases :


The number of containers and the characteristics of the containers can be precised. By default, we return emissions for one TEU (20G1, Dry)


You can give a non integer number of containers that allows you to calculate CO2 for LCL.
If you don't know the number of containers, you can pass the weight and/or volume and the API will estimate the number of containers. In case of reefer, please set containerSizeTypeCode = 22R1.


The response contains CO2e WTW (well-to-wheels) emissions in grams (g) for the historical route retrieved. Actual speeds and distances data are taken into account to compute precise emissions.

We also provide detailed emissions with TTW (tank-to-wheels) emissions and WTT (well-to-tank) emissions. The method takes into account the emissions caused by the fuel consumption of the main engines, the auxiliary engines and the boilers.

The response also returns the intensity factor (kg of CO2e per ton.kilometer) which is calculated based on the CO2e WTW, distance and the weight provided. If no weight has been provided, we estimate the weight based on the number of containers and their type (weight in properties)

The parameters field in the response contains all the parameters that were given in the request.

The properties field in the response gives some data that was used to calculate the CO2 based on the parameters for example the distance, the distance in ECA zones, some data about the vessel, the trade lane, etc. The property dataType precise if the data used to calculate the CO2 emissions is default data (representarive of average operating practices) or modeled data (taking into account vehicle information).

Methodology references

The method used to calculate emissions is based on the following references :

  • Third IMO Greenhouse Gas Study 2014;
  • Fourth IMO Greenhouse Gas Study 2020;
  • EMEP/EEA air pollutant emission inventory guidebook 2019;
  • GLEC Framework 2020.
Click Try It! to start a request and see the response here!