API CO2 emission

Number of APIs: 2

Welcome to the documentation of the CO2 API

Compatibility guidelines

The HTTP API is versioned with a single number, which is currently 2

This number symbolizes the major version number. New features can be added to the API in the same version number if there is no breaking change.

The version number is present in the url, for instance /co2/api/v2 for the current version.

Documentation, Pricing and Key generation

You can find the complete documentation for our API at Developers Platform.

Create an account to receive your FREE key in under a minute!

Additionally, explore our pricing plans, access support, view detailed documentation, and follow our comprehensive tutorials.

Authentication

Every endpoints of this API require authentication using an API key.

If you don't have an API Key and you need to use the CO2 API, you need to ask Sinay to have one.

To use the API Key, you must add a header named API_KEY with your API Key as a value.

Release note

2.3.0

  • Add new response field WTW per TEU/km.

2.2.0

  • Add speed as an optional input field.

2.1.0

  • Add WWT and WTW Co2 emissions to vessel method response.
  • Use the GLEC's fuel emission factor in vessel method.

2.0.0

  • Add usages endpoint to check the usage of the api
  • Co2 computation for a vessel from a port to another port using GLEC Framework recommendations
  1. Retrieve co2 consumption for a trip from one port to another. POST https://api.sinay.ai/co2/api/v2/compute-co2

  2. Retrieve your monthly usages GET https://api.sinay.ai/co2/api/v2/usages?startTime=1960-11-27T09:57:08.795Z&endTime=1960-11-27T09:57:08.795Z