Create Waste
Create Waste
Create a new waste record for a facility
POST
Create Waste
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
Your API key for authenticationExample:
sk_live_1234567890abcdefYour organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faBody Parameters
UUID of the facility this waste belongs toExample:
"660e8400-e29b-41d4-a716-446655440000"Waste identification name or invoice numberExample:
"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.0Description of the wasteExample:
"Municipal solid waste from office building"Waste destination or treatment facility nameExample:
"Waste treatment plant Madrid"Distance to waste treatment center in kilometersExample:
25.0UUID 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"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
Description of the waste
Start date of the waste period
End date of the waste period
Original waste quantity
Calculated quantity (base_quantity * percentage)
Current status:
uploaded, active, loading, or errorCO2 equivalent emissions in kg CO2e (calculated asynchronously)
Biogenic CO2 emissions in kg CO2e
Timestamp when the record was created
Example
Successful Response
Common Errors
401 Unauthorized
Cause: Missing or invalid API key403 Forbidden
Cause: Facility doesn’t belong to your organizationfacility_id belongs to your organization. Use the Facilities API to list available facilities.
422 Validation Error
Cause: Missing required fields or invalid valuesRelated Endpoints
List Wastes
Retrieve all waste records with filtering
Update Waste
Modify an existing waste record
Facilities
List facilities for your organization

