List Waste Emission Factors

Retrieve the legacy catalog of LER/RD code combinations and their waste_efs_id — read-only, no longer used to create or update wastes

GET /v1/waste-efs

List Waste Emission Factors

JavaScript

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/waste-efs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "items": {
    "id": "<string>",
    "low_code": "<string>",
    "low_name": {},
    "low_description": {},
    "rd_code": {},
    "rd_name": {},
    "rd_description": {},
    "region": "<string>"
  },
  "total": 123,
  "page": 123,
  "size": 123
}

← Wastes API

Returns a paginated list of all waste emission factor entries. Each entry maps a LER code (European Waste Catalogue) and an RD code (disposal/recovery operation) to a waste_efs_id.

Read-only. waste_efs_id is no longer accepted by POST /v1/wastes or PATCH /v1/wastes/{waste_id} — this endpoint now only serves existing records and reporting. To attach a standard emission factor on create/update, use waste_ler_code_id/waste_rd_code_id instead.

This is global reference data — it is the same for all organizations, and it only changes when Dcycle ships new factors, so it is safe to cache. Use the low_code and rd_code filters to narrow down to the entries relevant to your waste records.

Request

Headers

x-api-key · string · required

Your API key for authentication

Example: sk_live_1234567890abcdef

x-organization-id · string · required

Your organization UUID

Example: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Query Parameters

region · string

Filter by region code. Every factor Dcycle ships is global, so pass GLO unless support tells you otherwise — any other region code returns an empty list.

Example: GLO

low_code · string

Filter by exact LER code (European Waste Catalogue). Six digits, no spaces, plus a trailing * for hazardous waste, which is part of the code. Some entries carry a source prefix instead (DEFRA_2024-020107, OCCC_2025-140601*); the filter is an exact match on the stored value, so pass the code exactly as the catalog returns it.

Examples: 200101, 130507*, OCCC_2025-140601*

rd_code · string

Filter by exact RD code (disposal/recovery operation). Zero-padded to two digits — R3 returns nothing, R03 does. The catalog runs D01–D15 and R01–R14, and entries with no treatment recorded come back with rd_code: null.

Examples: D09, R03

page · integer · default: "1"

Page number for pagination

Example: 1

size · integer · default: "50"

Number of items per page (max 100)

Example: 50

Response

items · array[object]

Array of waste emission factor entries

Show Waste Emission Factor Object

id · string

The legacy waste_efs_id. No longer accepted as create/update input — kept for existing records and reporting only.

low_code · string

LER code (European Waste Catalogue), e.g. 130507*

low_name · string | null

LER code slug, e.g. aceitose_water_from_water_separators_oily_substances

low_description · string | null

LER code human-readable description, e.g. Aceitose water from water separators/oily substances.

rd_code · string | null

RD disposal/recovery operation code, e.g. D09 (zero-padded to two digits)

rd_name · string | null

RD code slug, e.g. other_fisic_chemics_not_in_anex

rd_description · string | null

RD code human-readable description, e.g. Other fisic chemics treatments not present in anex...

region · string

Region code. GLO for every factor Dcycle ships

total · integer

Total number of entries matching the current filters

page · integer

Current page number

size · integer

Number of items per page

Example

cURL

curl -X GET "https://api.dcycle.io/v1/waste-efs?region=GLO&low_code=130507*&rd_code=D09&page=1&size=10" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

Successful Response

{
  "items": [
    {
      "id": "ff906b9a-9568-455a-aae2-737bc66517cb",
      "low_code": "130507*",
      "low_name": "aceitose_water_from_water_separators_oily_substances",
      "low_description": "Aceitose water from water separators/oily substances.",
      "rd_code": "D09",
      "rd_name": "other_fisic_chemics_not_in_anex",
      "rd_description": "Other fisic chemics treatments not present in anex and which gives as a result a mix that gets eliminated with D1-D12 procedure",
      "region": "GLO"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 10
}

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

{ "detail": "Invalid API key" }

Solution: Verify your API key is valid and active.

Related Endpoints

Create Waste

Create a waste record (use the kernel LER/RD codes, not waste_efs_id)

List Wastes

Retrieve existing waste records for a facility