Official Alerts and Notifications

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:

Flood warning on August 7^th, 2025, with severity update on August 9^th, 2025:

{
            "source": "uk",
            "source_long": "UK DEFRA",
            "properties": {
                "flood_area_id": "013FWFGM19",
                "severity": "Severe Flood Warning",
                "severity_level": 1,
                "message": "Severe flooding expected. Danger to life.",
                "time_raised": "2025-08-07T08:00:00Z",
                "time_severity_changed": "2025-08-09T08:00:00Z"
            }
}

Query including options:
https://api.meteomatics.com/get_flood_alerts?datetime=2025-04-12T12:45Z&source=uk-defra&BBOX=46.0,6.5,49.0,12.5&with_area_geometry=true.

Current situation:
https://api.meteomatics.com/get_flood_alerts

Earthquakes

API endpoint for getting earthquakes in GeoJSON format. Sourced from United States Geological Survey & British Geological Survey.

Default end point to fetch all current active alerts:

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

With following options

Field	Description	Example
`time_range`	Time period of interest, further information here. Default are the last 24 hours.	`timerange=2025-08-01T00:00Z/P1M`
`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=6.3,40.8,9.3,48.2`

Output is GeoJSON of the following form:

{
	"features":[
	{
    	"geometry":{
			"coordinates":"..., decimals, decimal degrees [longitude, latitude]",
        	"type":"..., string, geometry"
	},
	"properties":{
		"depth_km":"..., decimal, depth of the event in km",
		"issue_time":"..., long integer, time when the event occurred",
		"magnitude":"..., decimal, magnitude for the event",
		"magnitude_type":"..., string, method used to calculate the preferred magnitude for the event",
		"source":"..., string, unique source identifier"
	},
	"type":"..."
	}
  ],
  "type":"..."
}

Further information on magnitude_type can be found here.

Example GeoJSON output:

Earthquake warning on August 1^st, 2025:

{
	"features":[
	{
    	"geometry":{
			"coordinates":[-5.21,57.072],
		"type":"Point"
	},
	"properties":{
		"depth_km":"3",
		"issue_time":"2025-08-01 16:45:37+00",
		"magnitude":"3.1",
		"magnitude_type":"ml",
		"source":"bgs"
	},
	"type":"Feature"
	},
	{
		"geometry":{
			"coordinates":[-5.211,57.071],
			"type":"Point"
	},
	"properties":{
        "depth_km":"3",
        "issue_time":"2025-08-01 16:45:01+00",
        "magnitude":"1.5",
        "magnitude_type":"ml",
        "source":"bgs"
	},
	"type":"Feature"
	}
  ],
  "type":"FeatureCollection"
}

Query including options:
https://api.meteomatics.com/get_earthquakes?time_range=2025-08-01T00:00ZP1D&bbox=-15,35,35,65.

Current situation:
https://api.meteomatics.com/get_earthquakes