Energi.AI API
The Energi.AI API connects your systems to the Energi.AI platform. With it you can:
- Upload activity and finance records, such as invoices, fuel and energy use or posting journal lines. Energi.AI classifies them and calculates their emissions. See Upload data.
- Read a company’s emissions: totals per GHG Protocol scope and category, over a range of months. See Read emissions.
- Read portfolios: groups of companies and their combined emissions. See Portfolios.
Regions
Energi.AI runs separately in the EU and in the US. Each region has its own dashboard, API and data, so an API key works only in the region it was created in. Use the region you sign in to:
| Region | Dashboard | API base URL |
|---|---|---|
| EU | dashboard.energi.ai | https://api.energi.ai |
| US | dashboard.us.energi.ai | https://api.us.energi.ai |
The EU | US switch at the top of every page sets the hosts in this site’s links and code samples. The region you pick stays in the page’s address as ?region=eu or ?region=us, and in every link to this site, section links included, so a link you share opens in the same region.
Versions
The current version is v3, and every path starts with /v3. Within v3, changes are only additive, so an integration keeps working as the API grows (see Conventions).
v1 and v2 are deprecated and stop working on 28 April 2027. If you use them, see Migrate from v1 and v2.
Where to start
Get an API key
An Admin or Owner of your company creates one in the dashboard and picks what it may do. See Get access.
Make your first call
List the companies your key can access, then read one company’s emissions. See Quickstart.
Read the basics
Authentication, Conventions and Errors and limits apply to every endpoint. They are short, and they explain how to read every response.
The field-by-field reference for every operation is in the API reference.