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
Your API key for authentication Example: sk_live_1234567890abcdef
Your organization UUID Example: a8315ef3-dd50-43f8-b7ce-d839e68d51fa
Body Parameters
UUID of the facility this waste belongs to Example: "660e8400-e29b-41d4-a716-446655440000"
Waste identification name or invoice number Example: "RSU-2024-001"
Start date of the waste period (ISO 8601 format) Example: "2024-01-01"
End date of the waste period (ISO 8601 format) Example: "2024-03-31"
Waste quantity in the specified unit. Must be greater than 0. Example: 1500.0
Description of the waste Example: "Municipal solid waste from office building"
Waste destination or treatment facility name Example: "Waste treatment plant Madrid"
Distance to waste treatment center in kilometers Example: 25.0
UUID of the quantity unit. Defaults to kilograms if not specified. Example: "61743a63-ff70-459c-9567-5eee8f7dfd5c"
UUID of the waste emission factor (based on LER/RD code combination) Example: "770e8400-e29b-41d4-a716-446655440000"
custom_emission_factor_id
UUID of a custom emission factor. For organizations with custom emission data. Example: "880e8400-e29b-41d4-a716-446655440000"
Response
Unique identifier (UUID) for the waste record
Waste identification name
Start date of the waste period
End date of the waste period
Calculated quantity (base_quantity * percentage)
Current status: uploaded, active, loading, or error
CO2 equivalent emissions in kg CO2e (calculated asynchronously)
Biogenic CO2 emissions in kg CO2e
Timestamp when the record was created
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"
}'
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" ,
"co2e" : 0.0 ,
"co2e_biomass" : 0.0 ,
"enabled" : true ,
"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