Create free API test account

Official Alerts and Notifications

UK Flood Alerts

UK Flood Alerts

API endpoint for getting flood warnings in JSON format. Currently only supports UK flood alerts, sourced from UK Department for Environment, Food and Rural Affairs.

Default end point to fetch all current active alerts:

http://api.meteomatics.com/get_flood_alerts?<fields>

With following options

Field Description Example
datetime Start and end times in which alert is active, default is 'now'. Further information here. datetime=2025-04-12T12:45Z
bbox A bounding box specified by maximal and minimal latitude and longitude formatted according to BBOX=<min_lon,min_lat,max_lon,max_lat>. The response will only contain alerts within this area. Default value is world ('-180,-90,180,90'), which will return alerts for all regions. bbox=5.8,45.7,10.7,47.9
source For now, only "uk-defra" available, default value shows all sources. source=uk-defra
with_area_geometry Allowed values: 'true', 'false', with default value 'false', i.e., the result will have no geometry information with_area_geometry=true

Output is JSON of the following form, with the contents of the "properties" field specific to the source: 

{
      "alerts": [
        {
          "source": "..., string, unique source identifier",
          "source_long": "..., string, long name",
          
          "flood_area": "..., object, optional, area geometry as geojson",

          "properties" : "... object, source specific properties"
        }
      ]
}

uk-defra specific format:

{
        "source": "uk-defra",
        "source_long": "UK Department for Environment, Food and Rural Affairs",
            
        "properties": {
            "time_message_changed": "...",
            "time_raised": "...",
            "time_severity_changed": "...",
    
            "description": "...",
            "ea_area_name": "...",
            "is_tidal": "...",
            "message": "...",
            "severity": "...",
            "severity_level": "...",
    
            "flood_area_id": "..."
        }
 }

The current (UK only) endpoint includes current active alerts, it does not include alerts which have recently become inactive. The severity level represents the strength of the warning, with 1 being the most severe:

Severity Level Meaning
1 Severe Flood Warning
2 Flood Warning
3 Flood Alert

Example JSON output: