These docs are for v1.0. Click to read the latest docs for v2.0.

This endpoint returns CO2e emissions (i.e CO2 equivalent emissions) for the shortest path between a source port and a target port for a specific carrier.

The calculation is made by averaging the CO2 emissions on the port pair of all the vessels that operate a service of the given carrier, on the trade lane associated with the port pair.

The carrier is given by id, see our /search/v2/carriers endpoint to get ids from a name or a SCAC.

The response contains CO2e WTW (well-to-wheels) emissions in g for the shortest route between departure and arrival ports. 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 number of containers and the size of the containers can be precised. You can give a non integer number of containers. By default, we return emissions for one TEU.

You can also do LCL estimations with weight and/or volume of a cargo fitting in one container. In this case, we will estimate the part of the container used for the cargo assuming the container is fully loaded. This method is less accurate than giving the number of containers and should only be used for rough estimates.

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 trade lane, the ids of the carriers services that operate the trade lane, etc.

Note that the distance we use to calculate CO2e is 15% higher than the shortest distance (returned in the response) as recommended by the GLEC framework to take into account the stops in other ports, the weather and all other deviations from the shortest route.

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.
Language
Authorization
Header
Click Try It! to start a request and see the response here!