Water Quality Data API

Water quality measurements and contaminant levels from monitoring stations worldwide. Track pH, turbidity, lead, chlorine, and other parameters with WHO guideline compliance checks.

Live

Base URL

https://api.crimate.net/v1/water

Authentication

Include your Water Quality API key in the Authorization header.

curl -H "Authorization: Bearer db_water_quality_live_YOUR_KEY" \
     https://api.crimate.net/v1/water/stats

Endpoints

GET/v1/water/stations

List water quality monitoring stations with optional filters

Parameters: country, region, water_body, page, per_page

Example

GET /v1/water/stations?country=ZA&region=Gauteng

GET/v1/water/stations/{stationCode}

Get details for a specific monitoring station

Parameters: stationCode (path)

Example

GET /v1/water/stations/ZA-GAU-001

GET/v1/water/measurements

Water quality measurements with filters by station, parameter, and date range

Parameters: station_code, parameter, from (YYYY-MM-DD), to (YYYY-MM-DD), page, per_page

Example

GET /v1/water/measurements?parameter=ph&from=2025-01-01

GET/v1/water/measurements/latest

Most recent measurement per parameter per station

Parameters: station_code (optional)

Example

GET /v1/water/measurements/latest

GET/v1/water/parameters

List all water quality parameters with WHO guideline values

Parameters: None

Example

GET /v1/water/parameters

GET/v1/water/compliance

Compliance reports by station, parameter, and period

Parameters: station_code, parameter, period, page, per_page

Example

GET /v1/water/compliance?station_code=ZA-GAU-001

GET/v1/water/stats

Dataset statistics (total stations, measurements, parameters)

Parameters: None

Example

GET /v1/water/stats

Response Examples

Latest measurements response:

{
  "measurements": [
    {
      "station_code": "ZA-GAU-001",
      "station_name": "Vaal Dam Intake",
      "parameter": "ph",
      "parameter_name": "pH",
      "value": 7.2,
      "unit": "pH units",
      "measurement_date": "2026-03-01",
      "who_guideline": 8.5,
      "compliant": true
    },
    {
      "station_code": "ZA-GAU-001",
      "station_name": "Vaal Dam Intake",
      "parameter": "turbidity",
      "parameter_name": "Turbidity",
      "value": 1.8,
      "unit": "NTU",
      "measurement_date": "2026-03-01",
      "who_guideline": 4.0,
      "compliant": true
    }
  ]
}

Try It

Enter your Water Quality API key to make a live request. Generate a key in the dashboard.

Try It

Make a live API call from your browser

API Key

Endpoint

GET

curl -H "Authorization: Bearer db_water_quality_live_YOUR_KEY" \
     "https://crimate.net/v1/water/stats"

Data Sources

EPA SDWIS

Safe Drinking Water Information System from the US Environmental Protection Agency. Covers public water systems, violations, and enforcement actions.

WHO Drinking Water Quality

World Health Organization guidelines for drinking-water quality. Defines safe levels for chemical, microbiological, and physical parameters.

SA Department of Water and Sanitation

Blue Drop and Green Drop water quality compliance data for South African municipalities.

Rate Limits

Tier	Price	Rate Limit	Daily Quota	Monthly Quota
Free	R0/mo	10 req/min	100	1,000
Starter	R899/mo	60 req/min	5,000	50,000
Pro	R3,499/mo	300 req/min	Unlimited	500,000

Error Codes

All error responses follow a consistent JSON format:

{
  "error": "error_code",
  "message": "Human-readable description."
}

Status	Error Code	Description
400	invalid_request	The request body or query parameters are malformed.
401	unauthorized	Missing or invalid API key.
403	no_subscription	No active subscription for this API product.
403	quota_exceeded	Daily or monthly quota exceeded.
404	not_found	The requested resource does not exist.
429	rate_limit_exceeded	Too many requests. Check X-RateLimit-Remaining header.
500	internal_error	An unexpected server error occurred.