Skip to main content
GET
Get Waste Version History
← Wastes API Returns a paginated list of all changes made to a waste, newest first: who made each change, when, and which fields it modified. Tracked fields: waste_ler_code_id, waste_rd_code_id, waste_efs_id, description, base_quantity, quantity, unit_id, start_date, end_date, identification_name, destination, total_km_to_waste_center, provider_name, transporter_name, file_url, file_name, percentage, facility_id, custom_emission_factor_id. Fields a recalculation rewrites (status, co2e) are not tracked, so a recalculation never reads as a user edit. A parent organization can read the history of a waste in one of its subsidiaries’ facilities.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

string
required
UUID of the wasteExample: 550e8400-e29b-41d4-a716-446655440000

Query Parameters

integer
default:"1"
Page number (1-based)
integer
default:"50"
Number of version entries per page
integer
Return only the change made by this transaction, with its diff, instead of the newest onesExample: 48291

Response

array[object]
Version entries with change details
integer
Total number of version entries
integer
Current page number
integer
Items per page
For CREATE operations, old_value is always null and new_value holds the initial value of each tracked field. For UPDATE operations, only the fields that changed are included in changes.

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key / JWT token

403 Forbidden

Cause: The authenticated user is not a member of the organization

404 Not Found

Cause: The waste does not exist or belongs to an organization outside yours and its subsidiaries

Get Waste

View the current state of a waste

Update Waste

Modify a waste