---
title: "Query emission factors"
method: GET
path: "/factors"
tags: ["factors"]
---

# Query emission factors

`GET /factors`

## Request

- Base URL: `https://www.sustainmetrics.net/api/v1`
- URL: `https://www.sustainmetrics.net/api/v1/factors`
- Auth: API key in header `X-API-Key`

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.

## Query parameters

- `source` 'defra' | 'epa' | 'ademe' | 'ember' | 'list', required
- `year` integer
- `scope` string
- `category` string
- `search` string
- `limit` integer
- `offset` integer

## Response `200`

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

- FactorResponse
  - `source` string
  - `year` integer
  - `total` integer: Total rows matching the filter, before pagination.
  - `count` integer: Rows in this response.
  - `offset` integer
  - `limit` integer
  - `usage` object
    - `calls_today` integer
    - `daily_limit` integer
    - `plan` 'free' | 'pro' | 'business'
  - `data` EmissionFactor[]
    - `source` string
    - `year` integer
    - `scope` string
    - `activity` string
    - `levels` object
      - `level_1` string
      - `level_2` unknown
      - `level_3` unknown
      - `level_4` unknown
    - `unit` unknown
    - `factors` object: Numeric coefficients — shape depends on source, see description above.

## Other responses

- `400`: Invalid or missing source.
- `401`: Missing or invalid API key.
- `404`: No data for the requested source/year combination.
- `429`: Daily rate limit exceeded for your plan.

## Changes

- **2026-07-31** `3d23eb361624`: 5 breaking, 1 warning, 9 info
  - for the `query` request parameter `year`, default value `2025` was added
  - for the `query` request parameter `limit`, default value was changed from `50` to `100`
  - removed the enum value `1` from the `query` request parameter `scope`
  - removed the enum value `2` from the `query` request parameter `scope`
  - …11 more

[Operation history](https://skmtc.dev/sustainmetrics/apis/sustainmetrics-emission-factor-api/changes/factors/get.md)

---

[API](https://skmtc.dev/sustainmetrics/apis/sustainmetrics-emission-factor-api.md) - [All operations](https://skmtc.dev/sustainmetrics/apis/sustainmetrics-emission-factor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sustainmetrics/apis/sustainmetrics-emission-factor-api/revisions/3d23eb361624?raw)
