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

# Emissions

> Query aggregated CO2e emissions by scope, category, or month

# Emissions

The Emissions endpoints let you retrieve **aggregated greenhouse gas emissions** for your organization. This is the primary way to answer questions like:

* "What are our total emissions for 2025?"
* "How do our Scope 1, 2, and 3 emissions compare?"
* "Which emission categories contribute the most?"
* "How do our emissions trend month over month?"

## Key Concepts

### Scopes (GHG Protocol)

The GHG Protocol defines three scopes of emissions:

| Scope       | Description                                     | Examples                                                         |
| ----------- | ----------------------------------------------- | ---------------------------------------------------------------- |
| **Scope 1** | Direct emissions from owned/controlled sources  | Vehicles, on-site combustion, refrigerant recharges              |
| **Scope 2** | Indirect emissions from purchased energy        | Electricity consumption                                          |
| **Scope 3** | All other indirect emissions in the value chain | Purchases, business travel, employee commuting, logistics, waste |

### Units

All emissions values are returned in **tCO2e** (tonnes of CO2 equivalent). This is the standard unit used in GHG Protocol reporting.

### Organization Hierarchy

Emissions are automatically aggregated across your organization and all its child organizations, giving you a consolidated view of your corporate group's footprint.

## Available Endpoints

<CardGroup cols={1}>
  <Card title="Get Emissions Summary" icon="chart-pie" href="/api-reference/emissions/get-summary">
    Retrieve aggregated emissions grouped by scope, category, or month
  </Card>
</CardGroup>

## Related Documentation

<CardGroup cols={2}>
  <Card title="MCP Tools" icon="robot" href="/mcp/emissions">
    Query emissions from AI assistants via MCP
  </Card>

  <Card title="Facilities API" icon="building" href="/api-reference/facilities/overview">
    Manage facilities that generate emissions
  </Card>
</CardGroup>