Skip to main content

​
Waste Water Treatment Tools

Query waste water treatment (WWT) records — treatment types, discharge parameters, flow volumes, and associated CO2e emissions. Covers Scope 1 emissions from wastewater processing.
Waste water treatment tools require a facility_id. Call list_facilities first to get one. Records are scoped to a single facility.

​
list_waste_water_treatments

List waste water treatment records for a facility with enriched data (co2e, user, linked projects). Paginated. Parameters:
ParameterTypeRequiredDefaultDescription
facility_idstringYes—Facility UUID. Call list_facilities first
start_datestringNo—Filter from date (YYYY-MM-DD)
end_datestringNo—Filter to date (YYYY-MM-DD)
statusstring[]No—Filter by record status (e.g. ["active"])
co2e_statusstringNo—Filter: calculated or not_calculated
project_idstringNo—Filter by project UUID
sortstringNo—Sort field, prefix - for desc (e.g. -start_date)
pageintegerNo1Page number
sizeintegerNo50Items per page (max 200)
organization_idstringNodefault orgOrganization UUID
Example response: 
{
  "items": [
    {
      "id": "wwt-uuid-...",
      "facility_id": "fac-uuid-...",
      "treatment_type": "aerobic",
      "start_date": "2025-01-01",
      "end_date": "2025-03-31",
      "flow_volume_m3": 12500.0,
      "population_equivalent": 5000,
      "co2e": 3.45,
      "co2e_status": "calculated",
      "status": "active",
      "created_by": {"id": "user-uuid", "name": "Ana Garcia"}
    }
  ],
  "total": 8,
  "page": 1,
  "size": 50
}
Key response fields:
FieldDescription
treatment_typeType of wastewater treatment (e.g. aerobic, anaerobic, lagoon)
flow_volume_m3Volume of wastewater treated in cubic meters
population_equivalentPopulation equivalent served by the treatment plant
co2eCalculated CO2-equivalent emissions in tonnes
co2e_statusWhether emissions have been calculated: calculated or not_calculated
Example prompts: 
"Show waste water treatments for facility X in Q1 2025"
"Which WWT records don't have calculated emissions yet?"
"List waste water treatments sorted by most recent first"

​
get_waste_water_treatment

Get full detail for a waste water treatment record — treatment type, flow volumes, discharge parameters, co2e breakdown, user info, and linked projects. Parameters:
ParameterTypeRequiredDefaultDescription
wwt_idstringYes—WWT record UUID
organization_idstringNodefault orgOrganization UUID
Example response: 
{
  "id": "wwt-uuid-...",
  "facility_id": "fac-uuid-...",
  "treatment_type": "aerobic",
  "start_date": "2025-01-01",
  "end_date": "2025-03-31",
  "flow_volume_m3": 12500.0,
  "population_equivalent": 5000,
  "discharge_bod": 25.0,
  "discharge_cod": 120.0,
  "sludge_quantity_tonnes": 8.5,
  "co2e": 3.45,
  "co2e_breakdown": {
    "discharge": 1.2,
    "sludge": 0.8,
    "population": 0.95,
    "water": 0.5
  },
  "created_by": {"id": "user-uuid", "name": "Ana Garcia"},
  "linked_projects": [{"id": "proj-uuid", "name": "ISO 14064 2025"}]
}
Key response fields:
FieldDescription
discharge_bodBiochemical oxygen demand of discharge (mg/L)
discharge_codChemical oxygen demand of discharge (mg/L)
sludge_quantity_tonnesQuantity of sludge produced in tonnes
co2e_breakdownEmissions split by sub-category (discharge, sludge, population, water)
linked_projectsProjects this record is associated with
Example prompts: 
"Show the details for this waste water treatment record"
"What's the emissions breakdown for this WWT record?"
"Which projects is this waste water treatment linked to?"

​
Workflow

A typical workflow for analyzing waste water treatment data:
  1. list_facilities — find the facility with wastewater operations
  2. list_waste_water_treatments — list WWT records for that facility, filtering by date or status
  3. get_waste_water_treatment — inspect a specific record’s co2e breakdown
  4. get_greenhouse_gas_emissions with category="waste_water_treatment_*" — see validated emissions across all WWT sub-categories
Waste water treatment emissions are split into four GHG categories: waste_water_treatment_discharge, waste_water_treatment_population, waste_water_treatment_sludge, and waste_water_treatment_water. Use get_greenhouse_gas_emissions with a specific category to query validated totals.

Emissions Tools

Query validated GHG emissions across all categories

Facilities Tools

List and manage facilities