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.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.
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_datetoend_date) - CO2e: Total emissions in kilograms of CO2 equivalent
Available Endpoints
List
Get all historical emission entries for your organization
Create
Add a new historical emission entry
Get
Retrieve a single entry by ID
Update
Modify an existing entry
Delete
Remove an entry
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) |