Get Historical Emission Version History
const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/historical-emissions/{historical_emission_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/historical-emissions/{historical_emission_id}/versions"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.dcycle.io/v1/historical-emissions/{historical_emission_id}/versions \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'{
"items": [
{}
],
"total": 123,
"page": 123,
"size": 123
}Get Historical Emission Version History
Who changed a historical emission entry, when, and which fields
GET
/
v1
/
historical-emissions
/
{historical_emission_id}
/
versions
Get Historical Emission Version History
const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/historical-emissions/{historical_emission_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/historical-emissions/{historical_emission_id}/versions"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.get(url, headers=headers)
print(response.text)curl --request GET \
--url https://api.dcycle.io/v1/historical-emissions/{historical_emission_id}/versions \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'{
"items": [
{}
],
"total": 123,
"page": 123,
"size": 123
}← Historical Emissions
Returns a paginated list of every change made to a historical emission entry: who made it, when, and the
before/after value of each tracked field. The entry can be one of your organization or of a company of its group.
Tracked fields:
organization_id, category, total_co2e, start_date, end_date, description, file_name.
Request
Headers
string
required
Your API key for authenticationExample:
sk_live_1234567890abcdefstring
required
Your organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faPath Parameters
string
required
UUID of the historical emission entryExample:
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"Query Parameters
integer
default:"1"
Page number (1-based)
integer
default:"50"
Number of version entries per page
Response
array
Version entries, newest first:
| Field | Type | Description |
|---|---|---|
transaction_id | integer | Internal transaction ID |
operation_type | string | CREATE, UPDATE or DELETE |
issued_at | datetime | null | When the change was committed |
user_id | string | null | User who made the change (null for system changes) |
user_first_name | string | null | First name of that user |
user_last_name | string | null | Last name of that user |
changes | array | { field, old_value, new_value } per tracked field that changed |
integer
Total number of version entries
integer
Current page number
integer
Page size
Example
cURL
curl -X GET "https://api.dcycle.io/v1/historical-emissions/${HISTORICAL_EMISSION_ID}/versions" \
-H "x-api-key: ${DCYCLE_API_KEY}" \
-H "x-organization-id: ${DCYCLE_ORG_ID}"
Successful Response
{
"items": [
{
"transaction_id": 1842,
"operation_type": "UPDATE",
"issued_at": "2026-10-30T09:12:00Z",
"user_id": "user-uuid-here",
"user_first_name": "Ana",
"user_last_name": "García",
"changes": [{ "field": "total_co2e", "old_value": 45200.5, "new_value": 46100.0 }]
}
],
"total": 2,
"page": 1,
"size": 50
}
Common Errors
401 Unauthorized
Cause: Missing or invalid API key{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}
404 Not Found
Cause: Historical emission not found, deleted, or outside your organization and its groupRelated Endpoints
Get
View the entry
Update
Modify an existing entry
Was this page helpful?