This is the Water Framework Directive (WFD) Open Data API which has seven API datasets: Catchment, Subcatchment, Waterbody, WaterbodyTrend, MonitoringProgramme, Dashboard and Search. This information is populated using the EPA’s CRM system, WFD Application and GIS Vector database. The Catchment Science Management Unit and the Aquatics team in the EPA manage this data via CRM and the WFD Application. The EPA provides this information to the public via the responsive catchments.ie website.
Contents
Open API Documentation (Swagger)
https://wfdapi.edenireland.ie/docs/index
WFD API Endpoints
Catchments
Retrieve all Catchments
https://wfdapi.edenireland.ie/api/catchment
Retrieve a specific Catchment including all related Subcatchments by entering the Code of the Catchment at the end of the URI, e.g. for the Foyle Catchment:
https://wfdapi.edenireland.ie/api/catchment/01
Subcatchments
Retrieve a Subcatchment within a Catchment including all related Waterbodies, e.g.
https://wfdapi.edenireland.ie/api/catchment/01/subcatchment/01_1
Waterbodies
Retrieve a Waterbody, e.g. IE_SE_16B020080
https://wfdapi.edenireland.ie/api/waterbody/IE_SE_16B020080
Waterbody Trends
Retrieve a specific trend related to a Waterbody, e.g. IE_SE_16B020080
https://wfdapi.edenireland.ie/api/waterbody/IE_SE_16B020080/trend/6612
Search
Search of Catchments and Subcatchments is possible using the search switch, and the number of results per page is determined using the size switch, e.g.
https://wfdapi.edenireland.ie/api/search?v=suir&size=5
Pagination is managed using the page switch, e.g.
https://wfdapi.edenireland.ie/api/search?v=suir&page=1&size=5
Dashboards
A number of dashboard or charting endpoints are provided to facilitate the charting of WFD data including Catchments, Waterbodies, Pressures, Water Quality Status and Trends.
https://wfdapi.edenireland.ie/api/charts/catchments
Monitoring Programmes
Retrieve monitoring programme details and frequencies for WFD monitoring stations linked to a Waterbody.
To retrieve summary information for the monitoring programmes related to a Waterbody for the monitoring programme iteration 2019-2021 use the following sample url:
https://wfdapi.edenireland.ie/api/monitoringprogramme/IE_NW_01F011100/summarize/IEMP2019-2021
To retrieve the monitoring programme frequencies for quality elements in the monitoring programmes related to a Waterbody for the monitoring programme iteration 2019-2021 use the following sample url:
To retrieve the details of monitoring programme stations related to a Waterbody for the monitoring programme iteration 2019-2021 use the following sample url:
https://wfdapi.edenireland.ie/api/monitoringprogramme/IE_NW_01F011100/stationdetails/IEMP2019-2021
The following url returns the list of monitoring programme iterations:
https://wfdapi.edenireland.ie/api/monitoringprogramme/iterations/IE_NW_01F011100
Areas for Action
List of WFD Areas for Action including start year and progress information. Optional parameters are chariteration (defaults to current open cycle) and type.
https://wfdapi.edenireland.ie/api/areaforaction
https://wfdapi.edenireland.ie/api/areaforaction?chariteration=CI000002&type=2
Search for WFD Areas for Action. Search parameters include name (at least 3 characters), chariteration (optional, defaults to current open cycle) and type (optional).
https://wfdapi.edenireland.ie/api/areaforaction/search?name=adr&chariteration=CI000002&type=1
List of WFD Catchment Projects including start year, cycle and progress information.
https://wfdapi.edenireland.ie/api/catchmentproject?chariteration=CI000002
License
The data provided in the API is licensed under a Creative Commons Attribution 4.0 International License.
