APIs for data access
The following Application Programming Interfaces (APIs) are available to access forecasts data from different forecasting chains in PHARES.
| Name | Access | Geographic domain | Status | Link |
|---|---|---|---|---|
| Demo | Open | West Africa and Sahel | Selected dates | https://api-demo-89447740177.europe-west4.run.app/api/ |
| WAS | Restricted | West Africa and Sahel | Operational data | https://api-was.phares-agrhymet.cilss.int/ |
| BFA | Restricted | Burkina Faso | Operational data | https://api-bf-89447740177.europe-west4.run.app/api/ |
- Make sure to have an account linked to Google. See how to link email to Google.
- Contact us to ask for access
Each API contains data for one or more storage zones, i.e. forecasting chains and an additional zone for storing bulletin templates. In each forecasting chain the data is structured into folders and then individual files. There are two types of folders:
- One folder with static data for the selected forecast chain. This folder is named "_static".
- Folders with forecast for a specific forecast issue date. These are named by the date, i.e. YYYYMMDD, e.g. 20250815
The following data is available in the static folder (no. 1)
- subbasins_pourpoint_coordinates.shp: Shapefile with polygons of subbasins (catchments) in the hydrological model HYPE.
- stations-cout.gpkg: GeoPackage file with points showing the locations of hydrometric stations in the hydrological model HYPE.
- thresholds-al-cout.txt: Textfile containing the flood hazard severity thresholds ("al") for discharge ("cout") from the HYPE model, for each subbasin.
