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

Get CO2 for road

This endpoint returns CO2e emissions (i.e CO2 equivalent emissions) for a voyage from a city to another by road. 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. 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.

The size of the truck (gross vehicle weight in tons) and 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 also contains the distance (in meters) and the parameters that were taken into account for the calculation, for example the size range of the truck (min and max gross weight), the fuel used and the load factor.

The emissions are calculated using the GLEC framework.

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

Query Params
string
required
Defaults to FRMRS

The LOCODE of the departure city.

string
required
Defaults to FRAOP

The LOCODE code of the arrival city.

integer
Defaults to 1000

The weight of shipped goods in kilograms.

string
Defaults to DIESEL

The fuel type. Can be DIESEL, CNG or LNG (or PETROL for vans (<3.5t)). North America only allows DIESEL.

integer
Defaults to 20

The gross vehicle weight of the truck in metric tons, between 0 and 60t.

string
Defaults to AVERAGE_MIXED

The type of cargo, either AVERAGE_MIXED or CONTAINER.

Responses

Language
Credentials
Header
Request
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json