Flood risk
The flood risk API can be used to retrieve a variety of information relating to the flood risk of a specific property or geographical location in the UK.
You can access, test and subscribe to the API at www.propeco.io/api.
GET /flood-risk
📄❓ See Code Samples (page bottom) for an example request.
Retrieves flood risk information about a specific property or geographical location in the UK, identified by either latitude & longitude or X & Y grid position.
Query Parameters
UPRN string Optional*
The UPRN (Unique Property Reference Number) of the property.
x_coord float Optional*
The X coordinate of the property in the BNG / EPSG:27700 coordinate system.
y_coord float Optional*
The Y coordinate of the property in the BNG / EPSG:27700 coordinate system.
latitude float Optional*
The latitude of the property in the ETRS89 / EPGSG:4258 coordinate system.
longitude float Optional*
The longitude of the property in the ETRS89 / EPGSG:4258 coordinate system.
*One of the following must be provided:
- An
x_coord&y_coordpair. - A
latitude&longitudepair. - A UPRN.
Response
Depending on the specific location you search for, the API response will include the following assessments of flood risk:
England
"england": {
"rivers_and_seas": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"flood_risk_description": null,
"nearest_flood_risk_zone": {
"max_annual_flood_risk": null,
"min_annual_flood_risk": 0.033,
"flood_risk_description": "High",
"distance": 183.93541281136288,
"nearest_point": {
"x_coord": 202396.2701000003,
"y_coord": 47244.66009999998,
"latitude": 50.29197487399054,
"longitude": -4.775593199076576
}
}
},
"surface_water": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"nearest_flood_risk_zone": {
"annual_flood_risk": 0.01,
"distance": 163.0970918670604,
"nearest_point": {
"x_coord": 202392.0022781975,
"y_coord": 47265.995987744536,
"latitude": 50.2921651,
"longitude": -4.7756642
}
}
}
},
Rivers and seas: This outlines the chance of flooding from rivers and the sea, taking account of flood defences and the condition they are in. It utilises the results of a national flood risk assessment - undertaken using modelling and local expertise - that splits affected areas into 50m x 50m cells and allocates each one of four flood risk likelihood categories:
- High: each year, there is a chance of flooding of greater than 1 in 30 (3.3%).
- Medium: each year, there is a chance of flooding of between 1 in 30 (3.3%) and 1 in 100 (1%).
- Low: each year, there is a chance of flooding of between 1 in 100 (1%) and 1 in 1000 (0.1%).
- Very Low: each year, there is a chance of flooding of less than 1 in 1000 (0.1%).
Surface water: This identifies areas that are at risk of surface water flooding (which occurs when rainwater overwhelms drainage systems) with a 3.3%, 1% and 0.1% chance of occurring each year.
Scotland
"scotland": {
"coast": {
"in_flood_risk_zone": true,
"annual_flood_risk": 0.005,
"nearest_flood_risk_zone": {
"annual_flood_risk": 0.005,
"nearest_point": null
}
},
"rivers": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"nearest_flood_risk_zone": {
"annual_flood_risk": 0.001,
"nearest_point": {
"x_coord": 249730,
"y_coord": 668905,
"latitude": 55.88975598430339,
"longitude": -4.404330331020616
}
}
},
"surface_water": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"nearest_flood_risk_zone": {
"annual_flood_risk": 0.005,
"nearest_point": {
"x_coord": 249836,
"y_coord": 668878,
"latitude": 55.88954669429922,
"longitude": -4.402622131175248
}
}
}
},
The API provides indicative flood hazard information that identifies locations at risk from coastal, river and surface water flooding. At-risk areas are categorised according to their likelihood of flooding:
- High: Each year this area has a 10% chance of flooding.
- Medium: Each year this area has a 0.5% chance of flooding.
- Low: Each year this area has a 0.1% chance of flooding.
Wales
"wales": {
"coast": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"flood_risk_description": null,
"nearest_flood_risk_zone": {
"max_annual_flood_risk": 0.01,
"min_annual_flood_risk": 0.001,
"flood_risk_description": "Low",
"distance": 548.2301294905103,
"nearest_point": {
"x_coord": 217749.999999473,
"y_coord": 246501.999997628,
"latitude": 52.086796782336094,
"longitude": -4.661487898667815
}
}
},
"rivers": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"flood_risk_description": null,
"nearest_flood_risk_zone": {
"max_annual_flood_risk": 0.01,
"min_annual_flood_risk": 0.001,
"flood_risk_description": "Low",
"distance": 58.6156312628265,
"nearest_point": {
"x_coord": 218017.999999474,
"y_coord": 247001.999997647,
"latitude": 52.09137546266871,
"longitude": -4.65784766428086
}
}
},
"surface_water": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"flood_risk_description": null,
"nearest_flood_risk_zone": {
"max_annual_flood_risk": 0.01,
"min_annual_flood_risk": 0.001,
"flood_risk_description": "Low",
"distance": 102.97976634005074,
"nearest_point": {
"x_coord": 217963.999999473,
"y_coord": 247003.999997642,
"latitude": 52.09137566191078,
"longitude": -4.658636077532234
}
}
}
},
The API provides indicative flood hazard information that identifies locations at risk from coastal or river flooding. At-risk areas are categorised according to their likelihood of flooding:
For rivers, surface water and small watercourses:
- High: each year, an area has a chance of flooding of greater than 1 in 30 (3.3%).
- Medium: each year, an area has a chance of flooding of between 1 in 100 (1%) and 1 in 30 (3.3%).
- Low: each year, an area has a chance of flooding of between 1 in 1000 (0.1%) and 1 in 100 (1%).
For the sea:
- High: each year, an area has a chance of flooding of greater than 1 in 30 (3.3%).
- Medium: each year, an area has a chance of flooding of between 1 in 200 (0.5%) and 1 in 30 (3.3%).
- Low: each year, an area has a chance of flooding of between 1 in 1000 (0.1%) and 1 in 200 (0.5%).
General features
For each type of flooding, if the location in question is not deemed to be at risk, the API provides details of the nearest flood zone (within 1km for rivers and seas, and within 250m for surface water). If none are found, this will be returned as null.
Note that flood modelling is inherently uncertain and so the assessments provided should be treated as indicative.
Nearest Coastal Point
"nearest_coastal_point": {
"elevation_metres": 1.7,
"distance": 194.36668953295597,
"azimuth_degrees": 151.24603063372072,
"x_coord": 202394.5,
"y_coord": 47231.6,
"latitude": 50.291856965004364,
"longitude": -4.775611189350636
},
The nearest coastal point is provided, as well as the distance to it, its direction from the property or location being searched for and its elevation.
Elevation
"elevation": {
"elevation_upper": 60,
"elevation_lower": 50,
"elevation_estimate": 55.87437430964115,
"distance_from_upper": 61.95136452347257,
"distance_from_lower": 43.50899816025484,
"azimuth_ascending_degrees": 325.4691742577052,
"azimuth_descending_degrees": 107.9279197618614,
"is_above_high_tide_line": true
}
The API provides the elevation (height above sea level) for the property or location being searched for. This searches against topographic data provided by Ordnance Survey and provides the elevation of the closest contour lines, an estimate of the elevation of the property or location itself, and an indication of whether this is above the high tide line.
Protected by flood defence
"flood_defences": {
"protected_by_flood_defence": false,
"nearest_location_protected_by_flood_defence": {
"distance": 382.4983660095818,
"nearest_point": {
"azimuth_degrees": 246.58505158076701,
"x_coord": 201950,
"y_coord": 47250,
"latitude": 50.29187318341807,
"longitude": -4.7818535222010805
}
}
}
The API assesses whether or not the property or location being searched for benefits from an existing flood defence. If not, the API returns details of the closest point (within a 1km radius) that benefits from a flood defence.
Note that this data is available for England and Wales only.
Evidence of historical flooding
"recorded_flood_events": {
"in_flood_event_boundary": false,
"events": [
{
"distance": 314.6337477679326,
"name": "CW9345 - Pentewan",
"start_date": "2014-02-04T00:00:00.000Z",
"end_date": "2014-02-04T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "overtopping of defences",
"nearest_point": {
"azimuth_degrees": 205.79132477338786,
"x_coord": 202164.1045,
"y_coord": 47118.7085999995,
"latitude": 50.29076566692928,
"longitude": -4.778782651364053
}
},
{
"distance": 314.6337477679326,
"name": "CW9366 - Pentewan",
"start_date": "2014-02-05T00:00:00.000Z",
"end_date": "2014-02-05T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "overtopping of defences",
"nearest_point": {
"azimuth_degrees": 205.79132477338786,
"x_coord": 202164.1045,
"y_coord": 47118.7085999995,
"latitude": 50.29076566692928,
"longitude": -4.778782651364053
}
},
{
"distance": 322.784148929302,
"name": "CW8189 - Pentewan",
"start_date": "1997-11-26T00:00:00.000Z",
"end_date": "1997-11-26T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "unknown",
"nearest_point": {
"azimuth_degrees": 276.0606641077585,
"x_coord": 201980.02,
"y_coord": 47436.0800000001,
"latitude": 50.2935547697785,
"longitude": -4.781530106296368
}
},
{
"distance": 327.2058025156578,
"name": "CW8438 - Pentewan",
"start_date": "2004-10-27T00:00:00.000Z",
"end_date": "2004-10-27T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "channel capacity exceeded (no raised defences)",
"nearest_point": {
"azimuth_degrees": 261.55737741114615,
"x_coord": 201977.34,
"y_coord": 47353.9600000009,
"latitude": 50.29281620732957,
"longitude": -4.781524648051942
}
},
{
"distance": 328.9317649604983,
"name": "CW9021 - Pentewan",
"start_date": "2010-11-17T00:00:00.000Z",
"end_date": "2010-11-17T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "channel capacity exceeded (no raised defences)",
"nearest_point": {
"azimuth_degrees": 261.20033509965765,
"x_coord": 201975.94,
"y_coord": 47351.6799999997,
"latitude": 50.29279525670251,
"longitude": -4.781543084048426
}
},
{
"distance": 331.9336997052324,
"name": "CW8111 - Pentewan",
"start_date": "1975-01-20T00:00:00.000Z",
"end_date": "1975-01-20T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "channel capacity exceeded (no raised defences)",
"nearest_point": {
"azimuth_degrees": 260.9153818272929,
"x_coord": 201973.23,
"y_coord": 47349.5899999999,
"latitude": 50.2927755730269,
"longitude": -4.78157998849822
}
},
{
"distance": 369.0453395110705,
"name": "CW9345 - Pentewan",
"start_date": "2014-02-03T00:00:00.000Z",
"end_date": "2014-02-03T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "overtopping of defences",
"nearest_point": {
"azimuth_degrees": 221.71471074403337,
"x_coord": 202055.4291,
"y_coord": 47126.5197000001,
"latitude": 50.29079937746715,
"longitude": -4.780310533496136
}
},
{
"distance": 687.6380328340831,
"name": "CW8382 - Pentewan",
"start_date": "1997-11-26T00:00:00.000Z",
"end_date": "1997-11-27T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "other",
"nearest_point": {
"azimuth_degrees": 273.9434377346509,
"x_coord": 201614.99,
"y_coord": 47449.2899999991,
"latitude": 50.29355078199276,
"longitude": -4.786655591299232
}
}
]
}
}
The API checks historical flood records to assesses whether there is a history of flooding at the property or location being searched for. If not, the API returns details of the closest points (up to 10, within a 1km radius) that have previoulsy been affected by flooding.
Note that this data is available for England and Wales only.
Code Samples
Request
With UPRN
curl \
-X GET \
--header "x-api-key: <API KEY>" \
https://api.propeco.io/flood-risk?uprn=UPRN
const results = await fetch(`https://api.propeco.io/flood-risk?uprn=${UPRN}`, {
headers: {
"x-api-key": API_KEY
},
});
const data = await results.json();
With latitude & longitude
curl \
-X GET \
--header "x-api-key: <API KEY>" \
https://api.propeco.io/flood-risk?latitude=LATITUDE&longitude=LONGITUDE
const results = await fetch(`https://api.propeco.io/flood-risk?latitude=${latitude}&longitude=${longitude}`, {
headers: {
"x-api-key": API_KEY
},
});
const data = await results.json();
With x_coord & y_coord
curl \
-X GET \
--header "x-api-key: <API KEY>" \
https://api.propeco.io/flood-risk?x_coord=X_COORD&y_coord=Y_COORD
const results = await fetch(`https://api.propeco.io/flood-risk?x_coord=${x_coord}&y_coord=${y_coord}`, {
headers: {
"x-api-key": API_KEY
},
});
const data = await results.json();
Response
{
"england": {
"rivers_and_seas": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"flood_risk_description": null,
"nearest_flood_risk_zone": {
"max_annual_flood_risk": null,
"min_annual_flood_risk": 0.033,
"flood_risk_description": "High",
"distance": 183.93541281117837,
"nearest_point": {
"x_coord": 202396.2701,
"y_coord": 47244.6601,
"latitude": 50.29197487399054,
"longitude": -4.7755931990765825
}
}
},
"surface_water": {
"in_flood_risk_zone": false,
"annual_flood_risk": 0,
"flood_risk_description": null,
"nearest_flood_risk_zone": {
"annual_flood_risk": 0.01,
"flood_risk_description": "Medium",
"distance": 163.0970918670604,
"nearest_point": {
"x_coord": 202392.0022781975,
"y_coord": 47265.995987744536,
"latitude": 50.2921651,
"longitude": -4.7756642
}
}
}
},
"scotland": null,
"wales": null,
"flood_defences": {
"protected_by_flood_defence": false,
"nearest_location_protected_by_flood_defence": {
"distance": 382.4983660095818,
"nearest_point": {
"azimuth_degrees": 246.58505158076701,
"x_coord": 201950,
"y_coord": 47250,
"latitude": 50.29187318341807,
"longitude": -4.7818535222010805
}
}
},
"elevation": {
"elevation_upper": 60,
"elevation_lower": 50,
"elevation_estimate": 55.87437430964115,
"distance_from_upper": 61.95136452347257,
"distance_from_lower": 43.50899816025484,
"azimuth_ascending_degrees": 325.4691742577052,
"azimuth_descending_degrees": 107.9279197618614,
"is_above_high_tide_line": true
},
"nearest_coastal_point": {
"elevation_metres": 1.7,
"distance": 194.36668953295597,
"azimuth_degrees": 151.24603063372072,
"x_coord": 202394.5,
"y_coord": 47231.6,
"latitude": 50.291856965004364,
"longitude": -4.775611189350636
},
"recorded_flood_events": {
"in_flood_event_boundary": false,
"events": [
{
"distance": 314.6337477679326,
"name": "CW9345 - Pentewan",
"start_date": "2014-02-04T00:00:00.000Z",
"end_date": "2014-02-04T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "overtopping of defences",
"nearest_point": {
"azimuth_degrees": 205.79132477338786,
"x_coord": 202164.1045,
"y_coord": 47118.7085999995,
"latitude": 50.29076566692928,
"longitude": -4.778782651364053
}
},
{
"distance": 314.6337477679326,
"name": "CW9366 - Pentewan",
"start_date": "2014-02-05T00:00:00.000Z",
"end_date": "2014-02-05T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "overtopping of defences",
"nearest_point": {
"azimuth_degrees": 205.79132477338786,
"x_coord": 202164.1045,
"y_coord": 47118.7085999995,
"latitude": 50.29076566692928,
"longitude": -4.778782651364053
}
},
{
"distance": 322.784148929302,
"name": "CW8189 - Pentewan",
"start_date": "1997-11-26T00:00:00.000Z",
"end_date": "1997-11-26T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "unknown",
"nearest_point": {
"azimuth_degrees": 276.0606641077585,
"x_coord": 201980.02,
"y_coord": 47436.0800000001,
"latitude": 50.2935547697785,
"longitude": -4.781530106296368
}
},
{
"distance": 327.2058025156578,
"name": "CW8438 - Pentewan",
"start_date": "2004-10-27T00:00:00.000Z",
"end_date": "2004-10-27T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "channel capacity exceeded (no raised defences)",
"nearest_point": {
"azimuth_degrees": 261.55737741114615,
"x_coord": 201977.34,
"y_coord": 47353.9600000009,
"latitude": 50.29281620732957,
"longitude": -4.781524648051942
}
},
{
"distance": 328.9317649604983,
"name": "CW9021 - Pentewan",
"start_date": "2010-11-17T00:00:00.000Z",
"end_date": "2010-11-17T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "channel capacity exceeded (no raised defences)",
"nearest_point": {
"azimuth_degrees": 261.20033509965765,
"x_coord": 201975.94,
"y_coord": 47351.6799999997,
"latitude": 50.29279525670251,
"longitude": -4.781543084048426
}
},
{
"distance": 331.9336997052324,
"name": "CW8111 - Pentewan",
"start_date": "1975-01-20T00:00:00.000Z",
"end_date": "1975-01-20T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "channel capacity exceeded (no raised defences)",
"nearest_point": {
"azimuth_degrees": 260.9153818272929,
"x_coord": 201973.23,
"y_coord": 47349.5899999999,
"latitude": 50.2927755730269,
"longitude": -4.78157998849822
}
},
{
"distance": 369.0453395110705,
"name": "CW9345 - Pentewan",
"start_date": "2014-02-03T00:00:00.000Z",
"end_date": "2014-02-03T00:00:00.000Z",
"flood_source": "sea",
"flood_cause": "overtopping of defences",
"nearest_point": {
"azimuth_degrees": 221.71471074403337,
"x_coord": 202055.4291,
"y_coord": 47126.5197000001,
"latitude": 50.29079937746715,
"longitude": -4.780310533496136
}
},
{
"distance": 687.6380328340831,
"name": "CW8382 - Pentewan",
"start_date": "1997-11-26T00:00:00.000Z",
"end_date": "1997-11-27T00:00:00.000Z",
"flood_source": "main river",
"flood_cause": "other",
"nearest_point": {
"azimuth_degrees": 273.9434377346509,
"x_coord": 201614.99,
"y_coord": 47449.2899999991,
"latitude": 50.29355078199276,
"longitude": -4.786655591299232
}
}
]
}
}
{
"title": "Flood Risk",
"description": "Information about flood risks around the property",
"type": "object",
"properties": {
"england": {
"description": "England-specific information about flood risks around the property",
"type": ["object", "null"],
"properties": {
"rivers_and_seas": {
"description": "Information about flood risks from rivers and seas",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from rivers and seas as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level",
"type": ["string", "null"]
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"max_annual_flood_risk": {
"description": "The maximum annual flood risk from rivers and seas for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"min_annual_flood_risk": {
"description": "The minimum annual flood risk from rivers and seas for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level for this point",
"type": "string"
},
"distance": {
"description": "The distance to the nearest flood risk zone in metres",
"type": "number"
},
"nearest_point": {
"description": "The nearest point of flood risk from rivers and seas to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from rivers and seas (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from rivers and seas (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from rivers and seas (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from rivers and seas (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
},
"surface_water": {
"description": "Information about flood risks from surface water",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from surface water as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"annual_flood_risk": {
"description": "The annual flood risk from surface water as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"distance": {
"description": "The distance to the nearest flood risk zone in metres",
"type": "number"
},
"nearest_point": {
"description": "The nearest point of flood risk from surface water to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from rivers and seas (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from rivers and seas (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from rivers and seas (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from rivers and seas (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
}
}
},
"scotland": {
"description": "Scotland-specific information about flood risks around the property",
"type": ["object", "null"],
"properties": {
"coast": {
"description": "Information about flood risks from coast",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from coast as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"annual_flood_risk": {
"description": "The annual flood risk from coast for this point as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"nearest_point": {
"description": "The nearest point of flood risk from coast to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"distance": {
"description": "The distance to the nearest point of flood risk from coast in metres",
"type": "number"
},
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from coast (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from coast (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from coast (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from coast (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
},
"rivers": {
"description": "Information about flood risks from rivers",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from rivers as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"annual_flood_risk": {
"description": "The annual flood risk from rivers for this point as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"nearest_point": {
"description": "The nearest point of flood risk from rivers to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"distance": {
"description": "The distance to the nearest point of flood risk from rivers in metres",
"type": "number"
},
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from rivers (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from rivers (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from rivers (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from rivers (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
},
"surface_water": {
"description": "Information about flood risks from surface water",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from surface water as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"annual_flood_risk": {
"description": "The annual flood risk from surface water for this point as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"nearest_point": {
"description": "The nearest point of flood risk from surface water to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"distance": {
"description": "The distance to the nearest point of flood risk from surface water in metres",
"type": "number"
},
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from surface water (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from surface water (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from surface water (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from surface water (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
}
}
},
"wales": {
"description": "Wales-specific information about flood risks around the property",
"type": ["object", "null"],
"properties": {
"rivers": {
"description": "Information about flood risks from rivers",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from rivers as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level",
"type": ["string", "null"]
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"max_annual_flood_risk": {
"description": "The maximum annual flood risk from rivers for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"min_annual_flood_risk": {
"description": "The minimum annual flood risk from rivers for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level for this point",
"type": "string"
},
"distance": {
"description": "The distance to the nearest flood risk zone in metres",
"type": "number"
},
"nearest_point": {
"description": "The nearest point of flood risk from rivers to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from rivers (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from rivers (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from rivers (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from rivers (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
},
"coast": {
"description": "Information about flood risks from coast",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from coast as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level",
"type": ["string", "null"]
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"max_annual_flood_risk": {
"description": "The maximum annual flood risk from coast for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"min_annual_flood_risk": {
"description": "The minimum annual flood risk from coast for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level for this point",
"type": "string"
},
"distance": {
"description": "The distance to the nearest flood risk zone in metres",
"type": "number"
},
"nearest_point": {
"description": "The nearest point of flood risk from coast to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from coast (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from coast (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from coast (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from coast (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
},
"surface_water": {
"description": "Information about flood risks from surface water",
"type": "object",
"properties": {
"in_flood_risk_zone": {
"description": "Whether the property is in a flood risk zone",
"type": "boolean"
},
"annual_flood_risk": {
"description": "The annual flood risk from surface water as a proportion",
"type": "number",
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level",
"type": ["string", "null"]
},
"nearest_flood_risk_zone": {
"description": "The nearest flood risk zone to the location",
"type": ["object", "null"],
"properties": {
"max_annual_flood_risk": {
"description": "The maximum annual flood risk from surface water for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"min_annual_flood_risk": {
"description": "The minimum annual flood risk from surface water for this point as a proportion",
"type": ["number", "null"],
"minimum": 0,
"maximum": 1
},
"flood_risk_description": {
"description": "A text description of the flood risk level for this point",
"type": "string"
},
"distance": {
"description": "The distance to the nearest flood risk zone in metres",
"type": "number"
},
"nearest_point": {
"description": "The nearest point of flood risk from surface water to the property. Will likely be on the edge of a flood risk area",
"type": ["object", "null"],
"properties": {
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from surface water (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from surface water (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from surface water (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from surface water (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
}
}
},
"flood_defences": {
"name": "Flood Defences",
"description": "Information about flood defences around the area",
"type": "object",
"properties": {
"protected_by_flood_defence": {
"description": "true if the location is in a zone with reduced flood risk due to flood defences",
"type": "boolean"
},
"nearest_location_protected_by_flood_defence": {
"description": "The nearest flood defence risk reduced zone",
"type": "object",
"properties": {
"distance": {
"description": "The distance from the nearest flood defence risk reduced zone",
"type": "number"
},
"nearest_point": {
"description": "The nearest point of the nearest flood risk reduced zone",
"type": "object",
"properties": {
"azimuth_degrees": {
"description": "The azimuth of the nearest point relative to the given location, in degrees",
"type": "number"
},
"x_coord": {
"description": "The x coordinate of the nearest point (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
},
"elevation": {
"name": "Elevation",
"description": "Information about the elevation of the location",
"type": "object",
"properties": {
"elevation_upper": {
"description": "The elevation of the nearest contour above the location, in metres",
"type": "number"
},
"elevation_lower": {
"description": "The elevation of the nearest contour below the location, in metres",
"type": "number"
},
"elevation_estimate": {
"description": "The estimated actual elevation of the location, based on its distance from the upper and lower contour elevations, in metres",
"type": "number"
},
"distance_from_upper": {
"description": "The distance from the nearest contour above the location, in metres",
"type": "number"
},
"distance_from_lower": {
"description": "The distance from the nearest contour below the location, in metres",
"type": "number"
},
"azimuth_ascending_degrees": {
"description": "The azimuth of the nearest ascending contour, in degrees",
"type": "number"
},
"azimuth_descending_degrees": {
"description": "The azimuth of the nearest descending contour, in degrees",
"type": "number"
},
"is_above_high_tide_line": {
"description": "true if the location is above the high tide line",
"type": "boolean"
}
}
},
"nearest_coastal_point": {
"description": "The nearest point coastal point to the property.",
"type": ["object", "null"],
"properties": {
"distance": {
"description": "The distance to the coast in metres",
"type": "number"
},
"x_coord": {
"description": "The x coordinate of the nearest point of flood risk from rivers (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point of flood risk from rivers (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point of flood risk from rivers (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point of flood risk from rivers (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
},
"recorded_flood_events": {
"name": "Recorded Flood Events",
"description": "A collection of recorded flood events around the location",
"type": "object",
"properties": {
"in_flood_event_boundary": {
"description": "true if the location is in the boundary of a recorded flood event",
"type": "boolean"
},
"events": {
"description": "A collection of nearby recorded flood events around the location",
"type": "array",
"items": {
"description": "A recorded flood event",
"type": "object",
"properties": {
"in_flood_event_boundary": {
"description": "true if the location was within the boundary of the flood event",
"type": "boolean"
},
"distance": {
"description": "The distance from the flood event in metres",
"type": "number"
},
"name": {
"description": "The name of the flood event",
"type": "string"
},
"start_date": {
"description": "The start date of the flood event",
"type": "string"
},
"end_date": {
"description": "The end date of the flood event",
"type": "string"
},
"flood_source": {
"description": "A description of the source of the flood event e.g. 'sea'",
"type": "string"
},
"flood_cause": {
"description": "A description of the cause of the flood event e.g. 'overtopping of defences'",
"type": "string"
},
"nearest_point": {
"description": "The nearest point of the flood event",
"type": "object",
"properties": {
"azimuth_degrees": {
"description": "The azimuth of the nearest point relative to the given location, in degrees",
"type": "number"
},
"x_coord": {
"description": "The x coordinate of the nearest point (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"y_coord": {
"description": "The y coordinate of the nearest point (BNG/EPSG:27700 coordinate system)",
"type": "number"
},
"latitude": {
"description": "The latitude of the nearest point (WGS84/EPSG:4326 coordinate system)",
"type": "number"
},
"longitude": {
"description": "The longitude of the nearest point (WGS84/EPSG:4326 coordinate system)",
"type": "number"
}
}
}
}
}
}
}
}
}
}