> ## Documentation Index
> Fetch the complete documentation index at: https://developers.manglai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Emissions

> Query calculated emissions

## Description

**Emissions** are automatically calculated from consumptions. The API lets you retrieve them as a list or as an aggregated dashboard.

## Endpoints

| Method | Path                          | Description         |
| ------ | ----------------------------- | ------------------- |
| GET    | `/api/v1/emissions`           | List emissions      |
| GET    | `/api/v1/emissions/dashboard` | Emissions dashboard |

## Dashboard

The dashboard allows filtering by:

* `companyId` (required)
* `startDate`, `endDate`
* `categoryIds`, `buildingIds`, `entityIds`
* `hasCountries` (include data by country)

## Example: Emissions dashboard

```bash theme={null}
curl -X GET "https://www.manglai.io/api/v1/emissions/dashboard?companyId=UUID&startDate=2025-01-01&endDate=2025-01-31" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Typical response

Includes data by scope, category, building, month, etc.