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));
import requests

url = "https://api.dcycle.io/v1/waste-efs"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)
curl --request GET \
  --url https://api.dcycle.io/v1/waste-efs \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>'
{
  "items": {
    "id": "<string>",
    "low_code": "<string>",
    "low_name": {},
    "low_description": {},
    "rd_code": {},
    "rd_name": {},
    "rd_description": {},
    "region": "<string>"
  },
  "total": 123,
  "page": 123,
  "size": 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

​
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}"

import requests
import os

headers = {
    "x-api-key": os.getenv("DCYCLE_API_KEY"),
    "x-organization-id": os.getenv("DCYCLE_ORG_ID"),
}

params = {
    "region": "GLO",
    "low_code": "200101",
    "page": 1,
    "size": 10,
}

response = requests.get("https://api.dcycle.io/v1/waste-efs", headers=headers, params=params)
result = response.json()

for entry in result["items"]:
    print(f"{entry['low_code']} + {entry['rd_code']} → {entry['id']}")

const axios = require('axios');

const headers = {
  'x-api-key': process.env.DCYCLE_API_KEY,
  'x-organization-id': process.env.DCYCLE_ORG_ID,
};

const params = {
  region: 'GLO',
  low_code: '200101',
  page: 1,
  size: 10,
};

axios.get('https://api.dcycle.io/v1/waste-efs', { headers, params })
  .then(response => {
    response.data.items.forEach(entry => {
      console.log(`${entry.low_code} + ${entry.rd_code} → ${entry.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
}

​
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