Skip to main content
GET
← Custom Emission Factors The versions of a database your organization can see. Record endpoints take a version id as source_id.
Beta. Part of the custom emission factors API, currently in beta. The contract may still change before general availability.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa
uuid
required
The database id.Example: 5f1c2e7a-3b4d-4e8f-9a01-2c3d4e5f6a7b
string
Also count, per version, the records linked to this category (matching_record_count).Example: wastes

Response

An array of versions:
uuid
Version id: the source_id used in record paths.
string
Internal name, generated from the database.
string
The version label you set.
integer
1 for the first version of the database, then 2, 3…
integer | null
Year the factors refer to.
string | null
Reference URL.
integer
Number of records.
integer | null
Records linked to the activity_category you filtered by; null without the filter.

Common Errors

401 Unauthorized

Missing or invalid API key.

403 Forbidden

LOGGED_USER_NOT_MEMBER: the API key’s user is not a member of the organization in x-organization-id.

404 CUSTOM_DATABASE_NOT_FOUND

The database does not exist or is not visible to your organization.

Create Version

A new version of the database

List Records

Records of a version