v2

latestOpenAPI 3.0.3Data licensing varies by source — see /methodology2026-07-31139.6 KB
factors

Query emission factors

Search and filter emission factors across DEFRA, EPA, ADEME and Ember. Pass source=list to get the catalogue of available sources and years instead of factor rows.

get/factors

Query parameters

source'defra' | 'epa' | 'ademe' | 'ember' | 'list' required

Data source, or "list" to enumerate available sources/years.

yearinteger

Publication year. Availability depends on source: DEFRA 2023-2026, EPA 2023-2025, ADEME 2024 only, Ember 2025 only.

scopestring

GHG Protocol scope filter, e.g. "1" or "1,2" (comma-separated). Matches "Scope 1", "1", etc.

categorystring

Free-text match against the factor's category hierarchy (levels.level_1..level_4) and activity name, e.g. "fuels", "electricity", "waste".

searchstring

Free-text search across the entire factor record, e.g. "natural gas", "aviation".

limitinteger

Rows to return. Capped at 500 regardless of the value passed.

offsetinteger

Pagination offset.

Response

Matching factors, or the source/year catalogue when source=list.

sourcestring
yearinteger
totalinteger

Total rows matching the filter, before pagination.

countinteger

Rows in this response.

offsetinteger
limitinteger

Example response

{
  "data": [
    {
      "scope": "Scope 1"
    }
  ]
}
All 1 operations