> ## 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.

# Historical Emissions

> Manage manual emission entries for historical periods not covered by automated data collection

# Historical Emissions

The Historical Emissions API lets you create manual CO2e emission entries for periods where automated data collection was not in place. These entries are included in your organization's total emissions alongside calculated values from invoices, logistics, and other data sources.

<Note>
  Historical emissions are **manual entries** — you provide the total CO2e value directly rather than having it calculated from source data. Use them for baseline years, legacy data, or categories not yet covered by automated imports.
</Note>

## Use Cases

* **Baseline years**: Add emissions from years before the organization started using Dcycle
* **Legacy data**: Import historical emission reports from spreadsheets or other tools
* **Gap filling**: Cover emission categories not yet automated (e.g. process emissions)

## Key Concepts

* **Category**: Maps to a GHG Protocol / ISO 14064 emission category (e.g. `electricity`, `transport`, `purchases`)
* **Scope**: Automatically derived from the category (1, 2, or 3)
* **Period**: Each entry covers a date range (`start_date` to `end_date`)
* **CO2e**: Total emissions in kilograms of CO2 equivalent

## Available Endpoints

<CardGroup cols={2}>
  <Card title="List" icon="list" href="/api-reference/historical-emissions/list">
    Get all historical emission entries for your organization
  </Card>

  <Card title="Create" icon="plus" href="/api-reference/historical-emissions/create">
    Add a new historical emission entry
  </Card>

  <Card title="Get" icon="magnifying-glass" href="/api-reference/historical-emissions/get">
    Retrieve a single entry by ID
  </Card>

  <Card title="Update" icon="pencil" href="/api-reference/historical-emissions/update">
    Modify an existing entry
  </Card>

  <Card title="Delete" icon="trash" href="/api-reference/historical-emissions/delete">
    Remove an entry
  </Card>
</CardGroup>

## Emission Categories

| Scope | Category               | Description                       |
| ----- | ---------------------- | --------------------------------- |
| 1     | `process`              | Industrial process emissions      |
| 1     | `recharge`             | Fuel recharges / vehicle fuel     |
| 1     | `stationary`           | Stationary combustion             |
| 1     | `transport`            | Owned transport                   |
| 2     | `electricity`          | Purchased electricity             |
| 3     | `purchases`            | Purchased goods & services        |
| 3     | `travels`              | Business travel                   |
| 3     | `wastes`               | Waste treatment                   |
| 3     | `capex`                | Capital goods                     |
| 3     | `employees_in_itinere` | Employee commuting (home-to-work) |
| 3     | `employees_in_labore`  | Employee commuting (work-related) |