This endpoint returns CO2e emissions (i.e CO2 equivalent emissions) statistics of a given carrier for a given port pair. The CO2e emissions are returned in grams per TEU.

The carrier can be given by SCAC or id.

We calculate the itineraries operated by the carrier based on their services (and the services of their alliance) and for each itinerary, we calculate the CO2e emissions of each vessel operating the service and return statistics.


The response contains CO2e WTW (well-to-wheels) emissions statistics with minimum value (i.e value of the greenest itinerary on average), maximum value (i.e value of the most emitting itinerary on average), average value of all the itineraries and standard deviations.
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 parameters field in the response contains all the parameters that were given in the request.

The properties field in the response gives the details of the CO2e statistics of each itinerary. The statistics of an itinerary are calculated on the vessels so the minimum value is the CO2 emissions of the greenest vessel on the service, etc. In case of an itinerary with transhipments, the minimum value is the sum of the minimum values of each leg of the itinerary.

Each itinerary is associated to a unique fingerprint (called "hash") that you can use to retrieve the details of the itinerary via the /itinerary/v2/hash endpoint.

Note that the distances we use to calculate CO2e values take into account all the stops in other ports the vessel does on the itinerary based on the service it operates.

The itineraries are calculated on up to date carriers services data. In case of a route with transhipments, note that the transhipment ports may not be the one actually operated.

Impact of the weight and number of containers on CO2e emissions and intensity calculation

For CO2e emissions:

The CO2e emissions only depend on the number of containers (nContainers). If you don't know the nContainers but you know the total weight of the goods, our algorithm will estimate the nContainers based on the weight.
If neither nContainers nor weight are provided, by default, we return emissions for one TEU (20G1, Dry).

For CO2e intensity:

The CO2e intensity depends on the weight. If you don't know the weight but you know the nContainers, our algorithm will estimate the weight based on the nContainers.

Note that you can give a non integer number of containers that allows you to calculate CO2e for LCL.

Methodology references

The method used to calculate emissions is the one available in our co2/v2/direct/sea endpoint and 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!