List LER Codes

Look up the id of a LER (European List of Waste) code, to send as waste_ler_code_id

GET /v1/wastes/ler-codes

List LER Codes

JavaScript

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

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

200

{
  "id": "<string>",
  "code": "<string>",
  "name": "<string>",
  "description": {}
}

← Wastes API

The catalog of LER codes (European List of Waste) Dcycle accepts. Send the id of an entry as waste_ler_code_id when you create wastes with POST /v2/wastes or update one with PATCH /v1/wastes/{waste_id}. Codes are six digits with no spaces (150106); a trailing * marks hazardous waste and is part of the code (130205*).

The catalog is the same for every organization and only changes when Dcycle adds codes: you can cache it.

This replaces the deprecated waste_efs_id, a single id for a LER + R/D pair: now the LER code and the treatment (R/D code) are sent separately. The old catalog, GET /v1/waste-efs, is read-only and no longer accepted on create or update.

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

search · string

Filter by code or description (case-insensitive substring match). Omit to get the full catalog.

Example: 150106

Response

Returns a plain array — not paginated.

id · string

UUID to send as waste_ler_code_id when creating a waste

code · string

LER code (European List of Waste), e.g. 200301

name · string

LER code name/slug

description · string | null

Human-readable description

Example

cURL

curl -X GET "https://api.dcycle.io/v1/wastes/ler-codes?search=150106" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

Successful Response

[
  {
    "id": "33d3e986-2e02-4aaa-8be0-708c143c02d9",
    "code": "150106",
    "name": "mixed_containers",
    "description": "Mixed containers."
  }
]

Related Endpoints

List R/D Codes

List treatment codes, optionally scoped to a chosen LER

Create Wastes (v2)

Create wastes with the waste_ler_code_id from this endpoint