Integrating APIs — Argentina (INA)


Working with the Argentinian National Institute of Water, this case study explored ways of integrating products using Application Programming Interfaces (APIs).



National Institute of Water (INA)


Río de la Plata Basin Hydrological Alert.

The information is obtained from external sources or is prepared by SIyAH. As it is a real-time service, the data is neither consolidated nor validated, therefore the Institute is not responsible for the quality of the data.


Working collaboratively with the HydroSOS team, INA advanced its existing API provide additional outputs to aid compatibility with the HydroSOS interface.

The existing INA API was called to display daily flow data. Next, a percentile data API endpoint was created to be called alongside the flow data in order to add the bandings for the reference climatology to the graphs (e.g. what flow is classified as “normal” or “below normal”), and to define the band of the current flow data. From these percentile data, a small Python function enabled the percentile data to be converted in json format thus displaying flows relative to climatology on the map.

HydroSOS integration steps

Access existing flow and gauge level API
Create additional API endpoint to output percentile data
Define current flow banding according to reference climatology
Use Python code to format percentile data to json map format