Home

Get Started

Get seamless access to Rwanda’s water-related data through our powerful API. Designed for stakeholders, researchers, and developers, the API provides real-time and historical insights into surface and groundwater resources, including river water levels and more.

With this API, you can integrate reliable water data into your applications, research, or decision-making processes to support sustainable water management and development.

The API is based on a simple token-based authentication mechanism. Users acquire a token at the beginning of the session and use it for all subsequent access during the session. For the REST version of the interface, the token can be passed explicitly in the query string of embedded in the HTTP header.

The API includes a set of methods for retrieving various lists of metadata from the API as well as methods for retrieving other data.

The best practice is to get the lists of metadata types and use those values in the data retrieval methods, but for relatively static systems it is also fine to ignore the metadata definitions and simply hard code the known values into the retrieval methods.

Our API uses the concept of server methods like POST for posting values such time series data, location data, description list etc. The server administrator defines these views and specifies the data that each end point can publish.