Get Waste

Retrieve a single waste record with enriched data

GET /v1/wastes/{waste_id}/detail

Get Waste

JavaScript

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

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

200

{
  "id": "<string>",
  "type": "<string>",
  "status": "<string>",
  "quantity": {},
  "base_quantity": {},
  "percentage": {},
  "identification_name": {},
  "description": {},
  "low_code": {},
  "rd_code": {},
  "total_km_to_waste_center": {},
  "start_date": {},
  "end_date": {},
  "co2e": {},
  "co2e_biomass": {},
  "facility_id": {},
  "uploaded_by": {},
  "source_invoice_id": {},
  "invoice_id": {},
  "file_url": {},
  "file_id": {},
  "file_name": {},
  "created_at": {},
  "updated_at": {},
  "custom_emission_factor_id": {},
  "custom_emission_factor": {},
  "error_messages": {},
  "unit": {
    "id": "<string>",
    "name": "<string>",
    "type": "<string>"
  },
  "user": {
    "id": "<string>",
    "first_name": {},
    "last_name": {},
    "email": "<string>",
    "prefix": {},
    "phone_number": {},
    "onboarding_done": true,
    "profile_img_url": {}
  },
  "linked_projects": {},
  "facility_percentages": {}
}

← 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

x-api-key · string · required

Your API key for authentication

Example: sk_live_1234567890abcdef

x-organization-id · string · required

Your organization UUID

Example: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Path Parameters

waste_id · string · required

UUID of the waste record

Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

Response

id · string

Waste record UUID

type · string

Always "wastes"

status · 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).
• active: calculated; older wastes carry it instead of uploaded.
• review: its factor, matched from the description, needs a person. Either a factor was applied with low confidence (the waste has emissions; someone should confirm it) or none could be applied (no emissions until someone picks one). error_messages contains LOW_CONFIDENCE_WASTE_FACTOR_MATCH.
• error: the emissions could not be calculated, usually because no emission factor covers its LER/R/D codes, or because it has no unit.

quantity · number | null

Waste quantity after facility allocation, in the specified unit

base_quantity · number | null

Original waste quantity before facility allocation

percentage · number | null

Facility allocation percentage (0–1)

identification_name · string | null

Waste stream identification name

description · string | null

Free-text description of the waste record

low_code · string | null

European Waste Catalogue (LER/LoW) code. See List LER Codes and List R/D Codes for the catalogs with their descriptions.

rd_code · string | null

Recovery/disposal operation code, zero-padded to two digits (D09, R03)

total_km_to_waste_center · number | null

Distance in km to the waste treatment center

start_date · string | null

Start date of the waste period (ISO 8601)

end_date · string | null

End date of the waste period (ISO 8601)

co2e · number | null

Calculated CO2 equivalent emissions in kg

co2e_biomass · number | null

CO2 equivalent biomass emissions in kg

facility_id · string | null

UUID of the facility this waste belongs to

uploaded_by · string | null

UUID of the user who created the record

source_invoice_id · string | null

Source waste UUID (if derived from a distributed waste record)

invoice_id · string | null

Same as identification_name (kept for consistency with other modules)

file_url · string | null

URL to download the linked file

file_id · string | null

UUID of the linked file

file_name · string | null

Name of the linked file

created_at · datetime

Timestamp when the record was created

updated_at · datetime | null

Timestamp when the record was last updated

custom_emission_factor_id · string | null

UUID of a custom emission factor, if applied

custom_emission_factor · object | null

Custom emission factor details, if applied

error_messages · array[string] | null

Codes from matching the emission factor, e.g. LOW_CONFIDENCE_WASTE_FACTOR_MATCH for a waste in review. A waste in error does not always carry one yet.

unit · object | null

Unit of measurement

Show Unit Object

id · string

Unit UUID

name · string

Unit display name (e.g., "kg", "t")

type · string

Unit category (e.g., "weight")

user · object | null

User who created the record

Show User Object

id · string

User UUID

first_name · string | null

First name

last_name · string | null

Last name

email · string

Email address

prefix · string | null

Phone prefix

phone_number · string | null

Phone number

onboarding_done · boolean

Whether onboarding is complete

profile_img_url · string | null

Profile image URL

linked_projects · array[object]

Projects linked to this waste record

facility_percentages · array[object]

Facility percentage allocations (for distributed waste records)

Example

cURL

curl "https://api.dcycle.io/v1/wastes/${WASTE_ID}/detail" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

Successful Response

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "type": "wastes",
  "status": "active",
  "quantity": 1250.5,
  "base_quantity": 1250.5,
  "percentage": null,
  "identification_name": "Paper & Cardboard",
  "description": null,
  "low_code": "200101",
  "rd_code": "R03",
  "total_km_to_waste_center": 45.0,
  "start_date": "2025-01-01",
  "end_date": "2025-03-31",
  "co2e": 26.26,
  "co2e_biomass": 0,
  "facility_id": "660e8400-e29b-41d4-a716-446655440000",
  "uploaded_by": "990e8400-e29b-41d4-a716-446655440000",
  "source_invoice_id": null,
  "invoice_id": "Paper & Cardboard",
  "file_url": null,
  "file_id": null,
  "file_name": null,
  "created_at": "2025-02-01T10:30:00Z",
  "updated_at": "2025-02-15T14:20:00Z",
  "custom_emission_factor_id": null,
  "custom_emission_factor": null,
  "error_messages": null,
  "unit": {
    "id": "ba80e6cb-86a4-4bb1-a0c5-8104365d523c",
    "name": "kg",
    "type": "weight"
  },
  "user": {
    "id": "990e8400-e29b-41d4-a716-446655440000",
    "first_name": "Ana",
    "last_name": "Garcia",
    "email": "[e-mail]",
    "prefix": null,
    "phone_number": null,
    "onboarding_done": true,
    "profile_img_url": null
  },
  "linked_projects": [],
  "facility_percentages": []
}

Common Errors

404 Not Found

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

{ "detail": "Waste not found" }

Related Endpoints

List Wastes

Browse waste records

Update Waste

Modify a waste record