External API

External Api is a an easy way to retrieve data from Energi.ai platform. API functionality allows you to quickly get information about emissions for every company that is in our system.

Steps to integrate

1. Contact support@energi.ai to get partnership agreement including a SECRET_TOKEN
2. SECRET_TOKEN is a permanent token you use to authorize to our system
3. To access emissions api you need to get an AUTH_TOKEN by sending request below

POST https://api.energi.ai/v1/auth/generate-token
body {
    "secret": "<SECRET_TOKEN>"
}
Response: AUTH_TOKEN

4. AUTH_TOKEN expires in 7 day
5. To get emissions use the endpoint below

GET https://api.energi.ai/v1/emissions/organization/NO/927611074?years[]=2019
headers {
    "Authorization": "Bearer <AUTH_TOKEN>"
}

API Documentation

You can find the most up to date api documentation and all provided endpoints with detailed schemas in our Swagger (opens in a new tab)