This endpoint returns CO2e emissions (i.e CO2 equivalent emissions) for a voyage from a city to another by road. The source and destination can be given either by locode or coordinates.

You must provide either fromLocode or fromCoordinates and either toLocode or toCoordinates.

The emissions are calculated using the real network distance.

The response contains WTW (well-to-wheels) CO2e emissions in g for the amount of goods carried and detailed emissions : WTT (well-to-tank) and TTW (tank-to-wheels).

The weight of the transported goods can be given. If no weight is specified, the API returns the amount of CO2e for 1 metric ton of goods, unless a number of containers is passed. If the weight is specified, you must also provide the size of the truck (gross vehicle weight in tons) except for North America where the truck size is not taken into account and unless you pass a number of containers.

The fuel type (among diesel, cng, lng or petrol for vans (<3.5t)) can be given for more accurate CO2e values. Note that the diesel type is 5% biodiesel and only diesel is available for North America.

The emissions are calculated based on the region. Supported regions are Europe, North America, South America, Africa and Asia.

You can also specify the type of cargo : either container or mixed.

The response contains the parameters (in the field parameters) that were passed in the query and the default values that were used. Depending on the combination of parameters you enter, the default values for other parameters may vary. For example, the default truckSize for average mixed goods is 3t while it is 33t for container.

The field properties contains information about the data that was used for the calculation, for example the distance, some characteristics about the truck, the hypothesis made for load factor, 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).

The emissions are calculated using the GLEC framework.

You can find detailed information about the calculation and the hypothesis in our Guide section.

Click Try It! to start a request and see the response here!