Register for an Authorisation Key

Once you have completed the form below, a member of our team will be in touch to discuss your intended usage & costs..





Shoothill’s Environmental Data API

The Environmental Data API gives access to various datasets supplied by the Environment Agency and does some analysis on historical data available for a particular station.

In most cases you will require an access & support licence to use the Shoothill API. This licence will require annual renewal. Once you have completed the form on the right, a member of our team will be in touch to discuss your intended usage & costs.

The API may be used in either a client side application or a server side application. In both cases the referrer URL must be set correctly. The following data options are available:

Telemetry items provides programmatic access to the Environment Agencies remote sensing gauges in the field. These gauges update their values depending on operational requirements. In addition to the current value data the API provides historical analysis of data recorded by each gauge where possible.

River Levels Inland – Provides the current value of all currently active River Levels and supports historical analysis by individual River Gauge. The feed data is compiled from data supplied by the Environment Agency.

River Levels Tidal – Provides the current value of all currently active Tidal River gauges and additionally supports historical analysis by River Gauge. The feed data is compiled from data supplied by the Environment Agency.

River Flow level – This data provides flow values from specific stations which support measuring river flow levels. The feed data is compiled from data supplied by the Environment Agency.

Groundwater – This data provides groundwater level measurements primarily from Borehole locations throughout the country. The feed data is compiled from data supplied by the Environment Agency.

Three Day Forecast – Provides access to the Environment Agencies three day flood forecast.

Full API documentation is available here.


Getting Started

To use the API you will need an API key. This can be obtained by filling in the form above. Once you have obtained an API key then you can use this to login.

The API is located at http://riverlevelsapi.shoothill.com/. Help for each component is located here: http://riverlevelsapi.shoothill.com/help.

Please see the API Documentation for an in depth description of the API methods.

The API is secured using header based authentication ticket. Once you have your API key you will need to Login to the API to use any of the API methods.