Skip to main content
GET
/
v1
/
waste-efs
List Waste Emission Factors
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));
{
  "items": {
    "id": "<string>",
    "low_code": "<string>",
    "low_name": {},
    "low_description": {},
    "rd_code": {},
    "rd_name": {},
    "rd_description": {},
    "region": "<string>"
  },
  "total": 123,
  "page": 123,
  "size": 123,
  "pages": 123
}

​
List Waste Emission Factors

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. Pass that UUID as waste_efs_id when creating a waste record via POST /v1/wastes.
This is global reference data — it is the same for all organizations. Use the region, 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 authenticationExample: sk_live_1234567890abcdef
​
x-organization-id
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

​
Query Parameters

​
region
string
Filter by region code. Use GLO for global factors, or a country code such as ES for Spain-specific factors.Example: GLO
​
low_code
string
Filter by exact LER code (European Waste Catalogue).Example: 200101
​
rd_code
string
Filter by exact RD code (disposal/recovery operation).Example: R3
​
page
integer
default:"1"
Page number for paginationExample: 1
​
size
integer
default:"50"
Number of items per page (max 100)Example: 50

​
Response

​
items
array[object]
Array of waste emission factor entries
​
total
integer
Total number of entries matching the current filters
​
page
integer
Current page number
​
size
integer
Number of items per page
​
pages
integer
Total number of pages

​
Example

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

​
Successful Response

{
  "items": [
    {
      "id": "79af0a1a-d54d-4ebe-8729-946b8a2fbc03",
      "low_code": "200101",
      "low_name": "paper_and_paperboard_recycled",
      "low_description": "Paper and paperboard (recycled)",
      "rd_code": "R3",
      "rd_name": "recycling_of_organic_substances",
      "rd_description": "Recycling/reclamation of organic substances",
      "region": "GLO"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 10,
  "pages": 1
}

​
Common Errors

​
401 Unauthorized

Cause: Missing or invalid API key 
{ "detail": "Invalid API key" }
Solution: Verify your API key is valid and active.

Create Waste

Create a waste record using the waste_efs_id from this endpoint

List Wastes

Retrieve existing waste records for a facility