List Waste Water Treatments

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

fetch('https://api.dcycle.io/v1/waste-water-treatments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v1/waste-water-treatments"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": {
    "id": "<string>",
    "type": "<string>",
    "status": "<string>",
    "invoice_id": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "facility_id": {},
    "quantity": 123,
    "base_quantity": 123,
    "m3_water_out": 123,
    "kg_sludge": 123,
    "percentage": 123,
    "co2e": {},
    "co2e_biomass": 123,
    "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": {}
    },
    "uploaded_by": {},
    "source_invoice_id": "<string>",
    "file_url": {},
    "linked_projects": {},
    "facility_percentages": {},
    "created_at": {}
  },
  "total": 123,
  "total2": 123,
  "total_general": 123,
  "page": 123,
  "size": 123
}

GET

waste-water-treatments

List Waste Water Treatments

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

fetch('https://api.dcycle.io/v1/waste-water-treatments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v1/waste-water-treatments"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": {
    "id": "<string>",
    "type": "<string>",
    "status": "<string>",
    "invoice_id": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "facility_id": {},
    "quantity": 123,
    "base_quantity": 123,
    "m3_water_out": 123,
    "kg_sludge": 123,
    "percentage": 123,
    "co2e": {},
    "co2e_biomass": 123,
    "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": {}
    },
    "uploaded_by": {},
    "source_invoice_id": "<string>",
    "file_url": {},
    "linked_projects": {},
    "facility_percentages": {},
    "created_at": {}
  },
  "total": 123,
  "total2": 123,
  "total_general": 123,
  "page": 123,
  "size": 123
}

List Waste Water Treatments

Retrieve a paginated list of waste water treatment (WWT) records for a specific facility. Each record includes enriched data: CO2e emissions, linked projects, the user who uploaded it, and facility breakdown information.

Request

Headers

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Query Parameters

string

required

UUID of the facility to retrieve waste water treatment records forExample: 660e8400-e29b-41d4-a716-446655440000

date

Filter records with a start date on or after this date (ISO 8601)Example: 2025-01-01

date

Filter records with an end date on or before this date (ISO 8601)Example: 2025-12-31

array[string]

Filter by record status. Can be specified multiple times.Available values: uploaded, active, loading, errorExample: status[]=active&status[]=uploaded

string

Filter by CO2e calculation statusAvailable values: calculated, not_calculatedExample: co2e_status=calculated

string

Filter by project UUIDExample: 770e8400-e29b-41d4-a716-446655440000

string

Sort field. Prefix with - for descending order.Example: -start_date (most recent first), invoice_id

integer

default:"1"

Page number for paginationExample: 1

integer

default:"50"

Number of items per page (max 100)Example: 50

Response

array[object]

Array of waste water treatment record objects

Show Waste Water Treatment Object

string

Unique identifier (UUID) for the WWT record. Use this as waste_water_treatment_id in DELETE /api/v1/waste_water_treatments/.

string

Always "waste_water_treatment"

string

Processing status: uploaded, active, loading, or error

string

Identification name or invoice number of the WWT record

date

Start date of the treatment period

date

End date of the treatment period

string | null

UUID of the facility this WWT belongs to

number

Volume of water entering treatment, in m³

number

Volume of water exiting treatment, in m³

number

Same as base_quantity — water output volume in m³

number

Mass of sludge produced, in kg

number

Percentage factor (always 1 for WWT records — they are not split across facilities)

number | null

CO2 equivalent emissions in kg CO2e. Populated asynchronously after record activation.

number

Biogenic CO2 emissions in kg CO2e

object

Unit of measurement (always cubic meters for WWT)

Show Unit Object

string

Unit UUID

string

Unit name (e.g. "cubic_metre_(m3)_total")

string

Unit category (e.g. "waste_water_treatments_flow_total")

object | null

User who uploaded or created the record

Show User Object

string

User UUID

string | null

First name

string | null

Last name

string

Email address

string | null

Phone prefix

string | null

Phone number

boolean

Whether onboarding is complete

string | null

Profile image URL

string | null

UUID of the user who created the record

string

Internal source record UUID (matches id for WWT records)

string | null

Download URL for any linked import file

array[object]

Projects this WWT record is linked to

array[object]

Facility distribution breakdown (always empty for WWT records)

datetime

Timestamp when the record was created

integer

Total active and uploaded WWT records in the facility (facility-wide counter, independent of filters)

integer

Number of WWT records currently being processed (loading status) in the facility

integer

Total records matching the current filters — use this for pagination calculations

integer

Current page number

integer

Number of items per page

Example

curl -X GET "https://api.dcycle.io/v1/waste-water-treatments?facility_id=660e8400-e29b-41d4-a716-446655440000&start_date=2025-01-01&end_date=2025-12-31&page=1&size=50" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

import requests
import os

headers = {
    "x-api-key": os.getenv("DCYCLE_API_KEY"),
    "x-organization-id": os.getenv("DCYCLE_ORG_ID"),
}

params = {
    "facility_id": "660e8400-e29b-41d4-a716-446655440000",
    "start_date": "2025-01-01",
    "end_date": "2025-12-31",
    "page": 1,
    "size": 50,
}

response = requests.get(
    "https://api.dcycle.io/v1/waste-water-treatments",
    headers=headers,
    params=params,
)

result = response.json()
for wwt in result["items"]:
    print(f"{wwt['invoice_id']}: {wwt['co2e']} kg CO2e")

const axios = require('axios');

const headers = {
  'x-api-key': process.env.DCYCLE_API_KEY,
  'x-organization-id': process.env.DCYCLE_ORG_ID,
};

const params = {
  facility_id: '660e8400-e29b-41d4-a716-446655440000',
  start_date: '2025-01-01',
  end_date: '2025-12-31',
  page: 1,
  size: 50,
};

axios.get('https://api.dcycle.io/v1/waste-water-treatments', { headers, params })
  .then(response => {
    response.data.items.forEach(wwt => {
      console.log(`${wwt.invoice_id}: ${wwt.co2e} kg CO2e`);
    });
  });

Successful Response

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "waste_water_treatment",
      "status": "active",
      "invoice_id": "WWT-2025-001",
      "start_date": "2025-01-01",
      "end_date": "2025-01-31",
      "facility_id": "660e8400-e29b-41d4-a716-446655440000",
      "quantity": 12500.0,
      "base_quantity": 12000.0,
      "m3_water_out": 12000.0,
      "kg_sludge": 850.0,
      "percentage": 1,
      "co2e": 4521.3,
      "co2e_biomass": 0.0,
      "unit": {
        "id": "987190d0-8ed9-4234-bceb-ab683761a7fe",
        "name": "cubic_metre_(m3)_total",
        "type": "waste_water_treatments_flow_total"
      },
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "first_name": "Ana",
        "last_name": "García",
        "email": "ana.garcia@company.com",
        "prefix": null,
        "phone_number": null,
        "onboarding_done": true,
        "profile_img_url": null
      },
      "uploaded_by": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "source_invoice_id": "550e8400-e29b-41d4-a716-446655440000",
      "file_url": null,
      "linked_projects": [],
      "facility_percentages": [],
      "created_at": "2025-02-01T10:30:00Z"
    }
  ],
  "total": 47,
  "total2": 0,
  "total_general": 12,
  "page": 1,
  "size": 50
}

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: The facility does not belong to your organization

{
  "detail": "Facility doesn't belong to organization",
  "code": "FACILITY_NOT_BELONG_TO_ORGANIZATION"
}

Solution: Verify the facility_id belongs to your organization.

422 Validation Error

Cause: Missing required facility_id or invalid query parameter values Solution: Ensure facility_id is provided and all filter values are valid.

Bulk Upload Waste Water Treatments

Create multiple WWT records at once

Delete Waste Water Treatment

Delete a single WWT record by ID

​List Waste Water Treatments

​Request

​Headers

​Query Parameters

​Response

​Example

​Successful Response

​Common Errors

​401 Unauthorized

​403 Forbidden

​422 Validation Error

​Related Endpoints

Bulk Upload Waste Water Treatments

Delete Waste Water Treatment

List Waste Water Treatments

Request

Headers

Query Parameters

Response

Example

Successful Response

Common Errors

401 Unauthorized

403 Forbidden

422 Validation Error

Related Endpoints