---
title: "List canonical emission filter facets"
method: GET
path: "/emissions/canonical/facets"
tags: ["Emissions"]
---

# List canonical emission filter facets

`GET /emissions/canonical/facets`

## Query parameters

- `startDate` string, date-time
- `endDate` string, date-time
- `query` string
- `scope` integer[]
- `regionCode` string[]
- `locationId` string[]
- `categoryName` string[]
- `supplierDisplay` string[]
- `amountUnit` string[]
- `origin` string[]
- `provenanceStatus` string[]
- `minCo2eTonnes` number
- `maxCo2eTonnes` number
- `documentId` string
- `item_type` 'carbon' | 'all'

## Response `200`

Canonical emission filter facets

- CanonicalEmissionFacetsResponse
  - `data` CanonicalEmissionFacets, required
    - `amountUnits` string[], required
    - `categoryNames` string[], required
    - `origins` string[], required
    - `provenanceStatuses` string[], required
    - `regionCodes` string[], required
    - `scopes` integer[], required
    - `supplierDisplays` string[], required
  - `meta` object

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greentally/esgai-api/revisions/4fccdcaa5e57/schema)