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
Retrieve the catalog of LER/RD code combinations and their waste_efs_id — needed when creating waste records
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 awaste_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
string
required
Your API key for authenticationExample:
sk_live_1234567890abcdefstring
required
Your organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faQuery Parameters
string
Filter by region code. Use
GLO for global factors, or a country code such as ES for Spain-specific factors.Example: GLOstring
Filter by exact LER code (European Waste Catalogue).Example:
200101string
Filter by exact RD code (disposal/recovery operation).Example:
R3integer
default:"1"
Page number for paginationExample:
1integer
default:"50"
Number of items per page (max 100)Example:
50Response
array[object]
Array of waste emission factor entries
Show Waste Emission Factor Object
Show Waste Emission Factor Object
string
UUID to use as
waste_efs_id in POST /v1/wastesstring
LER code (European Waste Catalogue), e.g.
200101string | null
LER code slug, e.g.
paper_and_paperboard_recycledstring | null
LER code human-readable description, e.g.
Paper and paperboard (recycled)string | null
RD disposal/recovery operation code, e.g.
R3string | null
RD code slug, e.g.
recycling_of_organic_substancesstring | null
RD code human-readable description, e.g.
Recycling/reclamation of organic substancesstring
Region code:
GLO for global, or a country code such as ESinteger
Total number of entries matching the current filters
integer
Current page number
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" }
Related Endpoints
Create Waste
Create a waste record using the
waste_efs_id from this endpointList Wastes
Retrieve existing waste records for a facility
Was this page helpful?