API reference
Introduction
The Catchment Data Explorer (CDE) helps you explore and download information about the water environment. It supports and builds upon the data in the river basin management plans. The Catchment Data API complements this by providing selective programmatic access to the data.
The terms used within the API are explained within our glossary and background on the data structure and key concepts can be found on our how to use page.
API summary
This is a brief summary of the APIs available, see below for details. In
the links in the tables {root} corresponds to this site domain.
Water Bodies
| What | API | Example |
|---|---|---|
| Boundary polygon for this Water Body | {root}/WaterBody/{WaterBody}.geojson | Example water body boundary |
| Shapefile for this Water Body | {root}/WaterBody/{WaterBody}/shapefile.zip | Example water body shapefile |
| Classifications for this Water Body | {root}/WaterBody/{WaterBody}/classifications.csv | Example water body classifications |
| Objectives for this Water Body | {root}/WaterBody/{WaterBody}/objectives.csv | Example water body objectives |
| Challenges for this Water Body | {root}/WaterBody/{WaterBody}/rnags.csv | Example water body challenges |
| Protected Areas linked to this Water Body | {root}/WaterBody/{WaterBody}/protected-areas.csv | Example protected areas for a water body |
Operational Catchments
| What | API | Example |
|---|---|---|
| Boundary polygon for this Operational Catchment | {root}/OperationalCatchment/{OperationalCatchment}.geojson | Example operational catchment boundary |
| Shapefile for this Operational Catchment | {root}/OperationalCatchment/{OperationalCatchment}/shapefile.zip | Example operational catchment shapefile |
| Classifications for this Operational Catchment | {root}/OperationalCatchment/{OperationalCatchment}/classifications.csv | Example operational catchment classifications |
| Measures for this Operational Catchment | {root}/OperationalCatchment/{OperationalCatchment}/measures.csv | Example operational catchment measures |
| Objectives for this Operational Catchment | {root}/OperationalCatchment/{OperationalCatchment}/objectives.csv | Example operational catchment objectives |
| Challenges for this Operational Catchment | {root}/OperationalCatchment/{OperationalCatchment}/rnags.csv | Example operational catchment challenges |
| Protected Areas linked to this Operational Catchment | {root}/OperationalCatchment/{OperationalCatchment}/protected-areas.csv | Example protected areas for a operational catchment |
Management Catchments
| What | API | Example |
|---|---|---|
| Boundary polygon for this Management Catchment | {root}/ManagementCatchment/{ManagementCatchment}.geojson | Example management catchment boundary |
| Shapefile for this Management Catchment | {root}/ManagementCatchment/{ManagementCatchment}/shapefile.zip | Example management catchment shapefile |
| Classifications for this Management Catchment | {root}/ManagementCatchment/{ManagementCatchment}/classifications.csv | Example management catchment classifications |
| Measures for this Management Catchment | {root}/ManagementCatchment/{ManagementCatchment}/measures.csv | Example management catchment measures |
| Objectives for this Management Catchment | {root}/ManagementCatchment/{ManagementCatchment}/objectives.csv | Example management catchment objectives |
| Challenges for this Management Catchment | {root}/ManagementCatchment/{ManagementCatchment}/rnags.csv | Example management catchment challenges |
| Protected Areas linked to this Management Catchment | {root}/ManagementCatchment/{ManagementCatchment}/protected-areas.csv | Example protected areas for a management catchment |
River Basin Districts (RBD)
| What | API | Example |
|---|---|---|
| Boundary polygon for this River Basin District | {root}/RiverBasinDistrict/{RiverBasinDistrict}.geojson | Example river basin district boundary |
| Shapefile for this River Basin District | {root}/RiverBasinDistrict/{RiverBasinDistrict}/shapefile.zip | Example river basin district shapefile |
| Classifications for this River Basin District | {root}/RiverBasinDistrict/{RiverBasinDistrict}/classifications.csv | Example river basin district classifications |
| Measures for this River Basin District | {root}/RiverBasinDistrict/{RiverBasinDistrict}/measures.csv | Example river basin district measures |
| Objectives for this River Basin District | {root}/RiverBasinDistrict/{RiverBasinDistrict}/objectives.csv | Example river basin district objectives |
| Challenges for this River Basin District | {root}/RiverBasinDistrict/{RiverBasinDistrict}/rnags.csv | Example river basin district challenges |
| Protected Areas linked to this River Basin District | {root}/RiverBasinDistrict/{RiverBasinDistrict}/protected-areas.csv | Example protected areas for a river basin district |
England
| What | API | Example |
|---|---|---|
| Boundary polygon for England | {root}/England.geojson | Example england boundary |
| Shapefile for England | {root}/England/shapefile.zip | Example england shapefile |
| Classifications for England | {root}/England/classifications.csv | Example england classifications |
| Measures for England | {root}/England/measures.csv | Example england measures |
| Objectives for England | {root}/England/objectives.csv | Example england objectives |
| Challenges for England | {root}/England/rnags.csv | Example england challenges |
| Protected Areas linked to England | {root}/England/protected-areas.csv | Example protected areas for england |