For agents and developers

Public API documentation

Otter's public endpoints are read-only and require no authentication. Responses are JSON. Official restriction records always take priority over model outlooks.

Endpoints

GET /api/v1/snapshot

National snapshot and restriction summary.

GET /api/v1/postcode/{postcode}

Water supplier, official status, and available outlook for a full postcode.

GET /api/v1/official-restrictions

Current verified water-company restriction records.

GET /api/v1/sources

Public source registry and commissioning states.

GET /api/v1/health

Runtime and publication freshness health.

Machine-readable discovery

See the OpenAPI description or the RFC 9727 API catalog.