List R/D Codes

Look up the id of an R/D (recovery/disposal) treatment code, to send as waste_rd_code_id

GET /v1/wastes/rd-codes

List R/D 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/rd-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 R/D codes: the recovery (R…) and disposal (D…) operations Dcycle accepts, from Annexes I and II of the Waste Framework Directive 2008/98/EC plus R14 (preparation for reuse), written with two digits (R03, not R3). Send the id of an entry as waste_rd_code_id when you create wastes with POST /v2/wastes or update one with PATCH /v1/wastes/{waste_id}. The field is optional, but send it when you know the treatment: without it only a factor defined for the LER code alone can be used.

Pass ler_code_id to get only the treatments that have an emission factor for that LER code. A pair outside that list is stored, but its calculation ends as CALCULATION_FAILED; a pair in it usually calculates.

This replaces the deprecated waste_efs_id, a single id for a LER + R/D pair: now the LER code and the treatment 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

ler_code_id · uuid

The id of a LER code: returns only the treatments that have an emission factor for it. Omit it to get the full catalog.

Example: 33d3e986-2e02-4aaa-8be0-708c143c02d9

Response

Returns a plain array — not paginated.

id · string

UUID to send as waste_rd_code_id when creating a waste

code · string

R/D operation code, e.g. R3, D1

name · string

R/D code name/slug

description · string | null

Human-readable description

Example

cURL

curl -X GET "https://api.dcycle.io/v1/wastes/rd-codes?ler_code_id=33d3e986-2e02-4aaa-8be0-708c143c02d9" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

Successful Response

[
  {
    "id": "6617caab-9db0-40df-8716-54d8c94e8056",
    "code": "R03",
    "name": "recycling_recovery_of_organic_substances",
    "description": "Recycling/recovery of organic substances"
  }
]

Related Endpoints

List LER Codes

List waste type codes to scope this endpoint with ler_code_id

Create Wastes (v2)

Create wastes with the waste_rd_code_id from this endpoint