Skip to main content
GET
Get Waste
← Wastes API Retrieve a single waste record by ID with enriched data including CO2e emissions, user who created it, unit details, and linked projects.

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 waste recordExample: f47ac10b-58cc-4372-a567-0e02b2c3d479

Response

string
Waste record UUID
string
Always "wastes"
string
Where the waste is in its calculation:
  • loading: waiting for its emission factor to be matched from the description.
  • uploaded: stored and calculated, or about to be (an ingest job tells you when). A factor matched from the description with low confidence leaves the waste uploaded, with its emissions and LOW_CONFIDENCE_WASTE_FACTOR_MATCH in error_messages: look for that code to find the factors to confirm in the Dcycle app.
  • active: calculated; older wastes carry it instead of uploaded.
  • review: no factor could be matched from its description for some year of its period. It has no emissions until someone picks a factor in the Dcycle app. error_messages contains LOW_CONFIDENCE_WASTE_FACTOR_MATCH. An edit that leaves a waste without the unit or quantity to calculate it also sets review.
  • error: the emissions could not be calculated, usually because no emission factor covers its LER/R/D codes, or because it has no unit.
number | null
Waste quantity after facility allocation, in the specified unit
number | null
Original waste quantity before facility allocation
number | null
Facility allocation percentage (0–1)
string | null
Waste stream identification name
string | null
Free-text description of the waste record
string | null
The waste’s LER (European List of Waste) code, as the LER catalog writes it: six digits with no spaces (200101, 130205*). The field keeps the name of the older LoW (List of Waste) catalog. null when the waste has no LER code. A waste priced from the older emission factor catalog may carry that catalog’s key, prefixed with its source (DEFRA_2024-150101). See List LER Codes and List R/D Codes for the catalogs with their descriptions.
string | null
The waste’s R/D (recovery/disposal) code, two digits (D09, R03). null when the waste has no treatment code
number | null
Distance in km to the waste treatment center
string | null
Start date of the waste period (ISO 8601)
string | null
End date of the waste period (ISO 8601)
number | null
Calculated CO2 equivalent emissions in kg
number | null
CO2 equivalent biomass emissions in kg
string | null
UUID of the facility this waste belongs to
string | null
UUID of the user who created the record
string
Id of the waste’s group: every share of a waste split across facilities carries the id of the first share, the entity_id its ingest job item returns. A waste of a single facility carries its own id.
boolean | null
Whether the waste is hazardous: derived from its LER code (a code ending in * is hazardous); null for a waste priced with a custom emission factor and no LER code; else the value stated for it. null when nothing says it
string | null
Who said it: user (a form, the API or a spreadsheet), document (read from a PDF) or ler (derived from the LER code). null with hazardous
string | null
Where the waste comes from: manual (the app’s form), api (sent with an API key), pdf (read from a document) or bulk_file (a spreadsheet import). null on older wastes created by hand or through the API. Every share of a split waste has the same one
string | null
The same value as identification_name, under the name the other record types use
string | null
URL to download the linked file
string | null
UUID of the linked file
string | null
Name of the linked file
object | null
The document attached to the waste (attachment_file_id), or null. Never the file the waste was read from (a PDF, a spreadsheet). For an older waste typed in a form, the document it was given then (file_url, file_name), whose file_id is null when only its URL was kept. A file deleted or moved to the trash is no longer attached.
datetime
Timestamp when the record was created
datetime | null
Timestamp when the record was last updated
string | null
UUID of a custom emission factor, if applied
object | null
Custom emission factor details, if applied
array[string] | null
Codes from matching the emission factor, e.g. LOW_CONFIDENCE_WASTE_FACTOR_MATCH for a waste whose factor was matched from its description with low confidence (uploaded) or could not be matched (review), and WASTE_DEFAULT_TREATMENT_ASSUMED for one whose description names a material but no treatment: it is calculated with the database’s default treatment for that material. To calculate the real one, name the treatment in the description, or send the LER code with its R/D code (on create or update). A waste in error may carry none.
object | null
Unit of measurement
object | null
User who created the record
array[object]
Projects linked to this waste record
array[object]
Facility percentage allocations (for distributed waste records)

Example

Successful Response

Common Errors

404 Not Found

Cause: Waste record does not exist or does not belong to your organization

List Wastes

Browse waste records

Update Waste

Modify a waste record