Retrieve co2 consumption for a trip from one port to another.

POST https://api.sinay.ai/co2/api/v2/compute-co2

This endpoint is used to compute the CO2 emissions of a TEU during its journey from a port to another port.

Request

Vessel

To identify the vessel, you can use the IMO (International Maritime Organization) or the MMSI (Maritime Mobile Service Identity).

You can also set an optional custom average speed for the vessel during the journey, in knots. By default the average speed will be computed by our routing system.

Departure

You can set up the departure port using its 5 digits UN Locode. Please make sure it is a Locode for a port.

Arrival

You can set up the arrival port using its 5 digits UN Locode. Please make sure it is a Locode for a port.

Response

The response will give you the voyage length in nautical miles and an estimation of the tons of CO2 emitted for this voyage, by TEU, with different methods.

Vessel model method

In this method, we model the journey from port to port of this vessel using our data models. We also use our database of ships to model their physical characteristics (hull, engine, capacity, etc.) to estimate their fuel consumption. The CO2 emission is then derived from the ship estimated fuel consumption.

This method computes only Tank to Wheel co2 emission (for the moment).

Tradelane method

In this method, we use the factors given by the GLEC Framework (2019 edit). From the departure and arrival, we deduce which tradelane have been used, and we find the corresponding emission factors. Then we apply these factors to the voyage length.

This method does not take into account specific vessel characteristics.

This method allows to estimate Well to Tank, Tank to Wheel and Well to Wheel (ie total) co2 emissions.

Request Body

{"vessel"=>{"imo"=>9706906, "speed"=>13}, "departure"=>{"portCode"=>"FRLEH"}, "arrival"=>{"portCode"=>"ESBCN"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{"input":{"vessel":{"imo":9706906,"mmsi":41895102,"speed":13},"departure":{"portCode":"Lorem aliqua dolore magna"},"arrival":{"portCode":"in cillum"}},"length":1709.7834398908199,"co2EmissionResult":{"vesselMethodResult":{"co2Wtt":0.043543922905257035,"co2Ttw":0.5275513736598448,"co2Wtw":0.5710952965651018},"tradeLaneMethodResult":{"co2Wtt":0.025332151445422387,"co2Ttw":0.32298493092913544,"co2Wtw":0.3483170823745578}}}