Create Waste

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    facility_id: '<string>',
    identification_name: '<string>',
    start_date: '<string>',
    end_date: '<string>',
    base_quantity: 123,
    description: '<string>',
    destination: '<string>',
    total_km_to_waste_center: 123,
    unit_id: '<string>',
    waste_efs_id: '<string>',
    custom_emission_factor_id: '<string>'
  })
};

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

import requests

url = "https://api.dcycle.io/v1/wastes"

payload = {
    "facility_id": "<string>",
    "identification_name": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "base_quantity": 123,
    "description": "<string>",
    "destination": "<string>",
    "total_km_to_waste_center": 123,
    "unit_id": "<string>",
    "waste_efs_id": "<string>",
    "custom_emission_factor_id": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.dcycle.io/v1/wastes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --data '
{
  "facility_id": "<string>",
  "identification_name": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "base_quantity": 123,
  "description": "<string>",
  "destination": "<string>",
  "total_km_to_waste_center": 123,
  "unit_id": "<string>",
  "waste_efs_id": "<string>",
  "custom_emission_factor_id": "<string>"
}
'

{
  "id": "<string>",
  "identification_name": "<string>",
  "description": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "base_quantity": 123,
  "quantity": 123,
  "percentage": 123,
  "destination": "<string>",
  "total_km_to_waste_center": 123,
  "status": "<string>",
  "error_messages": {},
  "co2e": 123,
  "co2e_biomass": 123,
  "enabled": {},
  "file_id": {},
  "file_name": {},
  "file_url": {},
  "created_at": {},
  "updated_at": {}
}

POST

wastes

Create Waste

const options = {
  method: 'POST',
  headers: {
    'x-api-key': '<x-api-key>',
    'x-organization-id': '<x-organization-id>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    facility_id: '<string>',
    identification_name: '<string>',
    start_date: '<string>',
    end_date: '<string>',
    base_quantity: 123,
    description: '<string>',
    destination: '<string>',
    total_km_to_waste_center: 123,
    unit_id: '<string>',
    waste_efs_id: '<string>',
    custom_emission_factor_id: '<string>'
  })
};

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

import requests

url = "https://api.dcycle.io/v1/wastes"

payload = {
    "facility_id": "<string>",
    "identification_name": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "base_quantity": 123,
    "description": "<string>",
    "destination": "<string>",
    "total_km_to_waste_center": 123,
    "unit_id": "<string>",
    "waste_efs_id": "<string>",
    "custom_emission_factor_id": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

curl --request POST \
  --url https://api.dcycle.io/v1/wastes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-organization-id: <x-organization-id>' \
  --data '
{
  "facility_id": "<string>",
  "identification_name": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "base_quantity": 123,
  "description": "<string>",
  "destination": "<string>",
  "total_km_to_waste_center": 123,
  "unit_id": "<string>",
  "waste_efs_id": "<string>",
  "custom_emission_factor_id": "<string>"
}
'

{
  "id": "<string>",
  "identification_name": "<string>",
  "description": "<string>",
  "start_date": "<string>",
  "end_date": "<string>",
  "base_quantity": 123,
  "quantity": 123,
  "percentage": 123,
  "destination": "<string>",
  "total_km_to_waste_center": 123,
  "status": "<string>",
  "error_messages": {},
  "co2e": 123,
  "co2e_biomass": 123,
  "enabled": {},
  "file_id": {},
  "file_name": {},
  "file_url": {},
  "created_at": {},
  "updated_at": {}
}

Create Waste

Create a new waste disposal record linked to a specific facility. The waste record will be processed for CO2e emissions calculation based on the emission factor and quantity provided.

CO2e Calculation: After creation, emissions are automatically calculated using the specified emission factor or custom emission factor. The co2e field will be updated asynchronously.

Request

Headers

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body Parameters

uuid

required

UUID of the facility this waste belongs toExample: "660e8400-e29b-41d4-a716-446655440000"

string

required

Waste identification name or invoice numberExample: "RSU-2024-001"

date

required

Start date of the waste period (ISO 8601 format)Example: "2024-01-01"

date

required

End date of the waste period (ISO 8601 format)Example: "2024-03-31"

number

required

Waste quantity in the specified unit. Must be greater than 0.Example: 1500.0

string

Description of the wasteExample: "Municipal solid waste from office building"

string

Waste destination or treatment facility nameExample: "Waste treatment plant Madrid"

number

Distance to waste treatment center in kilometersExample: 25.0

uuid

UUID of the quantity unit. Defaults to kilograms if not specified.Example: "61743a63-ff70-459c-9567-5eee8f7dfd5c"

uuid

UUID of the waste emission factor (based on LER/RD code combination)Example: "770e8400-e29b-41d4-a716-446655440000"

uuid

UUID of a custom emission factor. For organizations with custom emission data.Example: "880e8400-e29b-41d4-a716-446655440000"

Response

string

Unique identifier (UUID) for the waste record

string

Waste identification name

string

Description of the waste

date

Start date of the waste period

date

End date of the waste period

number

Original waste quantity

number

Adjusted quantity after applying percentage allocation

number

Allocation percentage (0–1)

string

Waste destination or treatment facility

number

Distance to waste treatment center in km

string

Current status: uploaded, active, loading, or error

array[string] | null

Error details when status is error

number

CO2 equivalent emissions in kg CO2e (calculated asynchronously)

number

Biogenic CO2 emissions in kg CO2e

boolean | null

Whether the waste record is enabled for emission calculations

string | null

UUID of the linked file (if created via bulk import)

string | null

Name of the linked import file

string | null

Download URL for the linked file

datetime

Timestamp when the record was created

datetime | null

Timestamp when the record was last updated

Example

curl -X POST "https://api.dcycle.io/v1/wastes" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}" \
  -H "Content-Type: application/json" \
  -d '{
    "facility_id": "660e8400-e29b-41d4-a716-446655440000",
    "identification_name": "RSU-2024-001",
    "start_date": "2024-01-01",
    "end_date": "2024-03-31",
    "base_quantity": 1500.0,
    "description": "Municipal solid waste",
    "destination": "Waste treatment plant Madrid",
    "total_km_to_waste_center": 25.0,
    "waste_efs_id": "770e8400-e29b-41d4-a716-446655440000"
  }'

import requests
import os

api_key = os.getenv("DCYCLE_API_KEY")
org_id = os.getenv("DCYCLE_ORG_ID")

headers = {
    "x-api-key": api_key,
    "x-organization-id": org_id,
    "Content-Type": "application/json"
}

payload = {
    "facility_id": "660e8400-e29b-41d4-a716-446655440000",
    "identification_name": "RSU-2024-001",
    "start_date": "2024-01-01",
    "end_date": "2024-03-31",
    "base_quantity": 1500.0,
    "description": "Municipal solid waste",
    "destination": "Waste treatment plant Madrid",
    "total_km_to_waste_center": 25.0,
    "waste_efs_id": "770e8400-e29b-41d4-a716-446655440000"
}

response = requests.post(
    "https://api.dcycle.io/v1/wastes",
    headers=headers,
    json=payload
)

waste = response.json()
print(f"Waste created: {waste['id']}")
print(f"Status: {waste['status']}")

const axios = require('axios');

const apiKey = process.env.DCYCLE_API_KEY;
const orgId = process.env.DCYCLE_ORG_ID;

const headers = {
  'x-api-key': apiKey,
  'x-organization-id': orgId,
  'Content-Type': 'application/json'
};

const payload = {
  facility_id: "660e8400-e29b-41d4-a716-446655440000",
  identification_name: "RSU-2024-001",
  start_date: "2024-01-01",
  end_date: "2024-03-31",
  base_quantity: 1500.0,
  description: "Municipal solid waste",
  destination: "Waste treatment plant Madrid",
  total_km_to_waste_center: 25.0,
  waste_efs_id: "770e8400-e29b-41d4-a716-446655440000"
};

axios.post('https://api.dcycle.io/v1/wastes', payload, { headers })
  .then(response => {
    const waste = response.data;
    console.log(`Waste created: ${waste.id}`);
  })
  .catch(error => console.error(error));

Successful Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "identification_name": "RSU-2024-001",
  "description": "Municipal solid waste",
  "start_date": "2024-01-01",
  "end_date": "2024-03-31",
  "base_quantity": 1500.0,
  "quantity": 1500.0,
  "percentage": 1.0,
  "destination": "Waste treatment plant Madrid",
  "total_km_to_waste_center": 25.0,
  "status": "uploaded",
  "error_messages": null,
  "co2e": 0.0,
  "co2e_biomass": 0.0,
  "enabled": true,
  "file_id": null,
  "file_name": null,
  "file_url": null,
  "created_at": "2024-11-24T10:30:00Z",
  "updated_at": "2024-11-24T10:30:00Z"
}

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

{
  "detail": "Invalid API key",
  "code": "INVALID_API_KEY"
}

Solution: Verify your API key is valid and active.

403 Forbidden

Cause: Facility doesn’t belong to your organization

{
  "detail": "Facility doesn't belong to organization",
  "code": "FACILITY_NOT_BELONG_TO_ORGANIZATION"
}

Solution: Verify that the facility_id belongs to your organization. Use the Facilities API to list available facilities.

422 Validation Error

Cause: Missing required fields or invalid values

{
  "detail": [
    {
      "loc": ["body", "base_quantity"],
      "msg": "ensure this value is greater than 0",
      "type": "value_error.number.not_gt"
    }
  ]
}

Solution: Check that all required fields are provided and values are valid.

List Wastes

Retrieve all waste records with filtering

Update Waste

Modify an existing waste record

Facilities

List facilities for your organization

Get Waste Update Waste

​Create Waste

​Request

​Headers

​Body Parameters

​Response

​Example

​Successful Response

​Common Errors

​401 Unauthorized

​403 Forbidden

​422 Validation Error

​Related Endpoints

List Wastes

Update Waste

Facilities

Create Waste

Request

Headers

Body Parameters

Response

Example

Successful Response

Common Errors

401 Unauthorized

403 Forbidden

422 Validation Error

Related Endpoints