England
SupportedRiver, sea, surface water, defended probability, reservoirs, recorded outlines, defences and NCERM coastal mapping.
Location intelligence
Screen a property location in England, Wales or Scotland against flood zones, flood probability, recorded flood history, nearby defences, surface-water, reservoir and coastal erosion mapping. Use it as a flood risk data API inside your own property checks.
/api/v1/property/flood-riskProvide postcode, or both latitude and longitude.
Geographic availability
The colour is a geographic coverage indicator, not a risk score. Always inspect source status and completeness in the API response.
River, sea, surface water, defended probability, reservoirs, recorded outlines, defences and NCERM coastal mapping.
NRW flood zones, river, sea and surface-water risk, recorded flood extents, defences and NCERM erosion are configured. Reservoir and coastal ground-instability maps are not.
SEPA river, coastal and surface-water likelihood maps are configured. Reservoir, erosion, recorded-history and defence data are not.
DfI Rivers flood sources are not configured.
Cost per successful request
A successful request costs 10 credits and checks the flood categories available for the property location.
Deducted after a successful response.
Handler errors are not charged. A successful partial screen is charged.
Checks EA Flood Zones 2 and 3 in England, NRW Flood Map for Planning zones in Wales, or the highest SEPA river and coastal likelihood band in Scotland, and normalises the result into a severity.
Returns the RoFRS band with minimum-depth layers in England, or the Flood Risk Assessment Wales high, medium or low band in Wales. Both take account of flood defences.
Returns published risk bands and confidence values where the relevant source layer matches.
For England, checks dry-day and wet-day credible worst-case reservoir failure extents and returns available reservoir and lead-authority context.
Checks NCERM erosion projections, with 2055 and 2105 horizons in England and 2025, 2055 and 2105 no active intervention zones in Wales. Coastal ground-instability zones are England only.
Checks whether the location intersects an Environment Agency Recorded Flood Outline or an NRW Recorded Flood Extent and returns available event dates, source and cause.
Returns up to 25 EA or NRW defence assets inside the requested radius, with rounded distance. EA records add condition data; NRW records add the protection type and maintainer.
Returns the height above mean sea level of the OS Terrain 50 cell (50 m) that contains the location, in metres to 0.1 m. Great Britain only.
complete=false means at least one expected provider failed. Provider plumbing is deliberately excluded from the response.
Returns the highest normalised severity and matching category details.
| Field | Meaning |
|---|---|
| data.complete | True only when every source expected for the resolved country answered successfully. |
| data.coverage | Resolved country, both England and Wales providers for coordinate-only input, or not-covered for Northern Ireland. |
| data.location | Resolved property location and the radius used for nearby flood-defence checks. |
| data.riskLevel | Highest normalised level: none, low, medium or high, or not_covered when the nation has no configured flood data. |
| data.risks | Eight fixed risk keys. Each contains riskLevel, count and a short details array. riskLevel is not_covered when no open source exists for that category in the nation. |
| data.elevation | Ground height in metres above mean sea level (metres), with source and resolutionMetres, from the 50 m OS Terrain 50 grid. null in Northern Ireland, outside Great Britain or when the lookup fails. It does not affect complete. |
Use canonical coordinates
curl -X GET "https://propertyinsights.co.uk/api/v1/property/flood-risk?latitude=52.123&longitude=-1.234" \
-H "x-api-key: YOUR_API_KEY"Use a wider defence search radius
curl -X GET "https://propertyinsights.co.uk/api/v1/property/flood-risk?postcode=ZZ1%201ZZ&radiusMetres=1000" \
-H "x-api-key: YOUR_API_KEY" Successful chargeable JSON responses include a top-level billing object. The endpoint examples on this page focus on the endpoint-specific data, so this repeated block may not be shown in every example.
"billing": {
"mode": "prepaid",
"creditsCharged": 1,
"creditsRemaining": 1999,
"creditsRefreshAt": "2026-08-14T09:30:00.000Z"
}| Field or header | Meaning |
|---|---|
| billing.creditsCharged X-Credits-Charged | Credits charged by this call. Failed and non-chargeable calls return 0 in the header. |
| billing.creditsRemaining X-Credits-Remaining | The credit balance after the call. |
| billing.creditsRefreshAt X-Credits-Refresh-At | The next monthly credit refresh as an ISO 8601 timestamp. Trial and non-renewing balances return null and omit the header. |
All authenticated API-key calls expose the billing headers, including validation errors and zero-credit status or management requests. Only successful chargeable JSON responses add the billing object to the response body.
If your balance is lower than the cost of a request, the API returns HTTP 402 and charges nothing. The error includes the credits needed, your balance and a link to change plan.
{
"statusCode": 402,
"statusMessage": "Payment Required",
"data": {
"success": false,
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 35 API credits. Upgrade your plan or wait for your monthly refresh: https://propertyinsights.co.uk/billing",
"required": 35,
"available": 12,
"upgradeUrl": "https://propertyinsights.co.uk/billing"
}
}
}| Name | Required | Type | Description |
|---|---|---|---|
| postcode | No | string | Full England or Wales postcode. Alternatively provide coordinates. |
| latitude | No | number | Latitude when postcode is omitted. |
| longitude | No | number | Longitude when postcode is omitted. |
| radiusMetres | No | integer | Nearby flood-defence search radius from 25 to 2,000 metres. Defaults to 250. |
This is mapped screening data, not a property-specific flood assessment. An empty result does not establish that a property has never flooded or is insurable.
curl -X GET "https://propertyinsights.co.uk/api/v1/property/flood-risk?postcode=ZZ1%201ZZ" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"location": {
"postcode": "ZZ1 1ZZ",
"country": "england",
"latitude": 52.123,
"longitude": -1.234,
"radiusMetres": 250
},
"coverage": "england",
"complete": true,
"riskLevel": "medium",
"risks": {
"riverAndSea": {
"riskLevel": "medium",
"count": 1,
"details": [
{
"type": "river",
"classification": "2"
}
]
},
"riverAndSeaLikelihood": {
"riskLevel": "medium",
"count": 1,
"details": [
{
"classification": "Medium",
"minimumDepthMetres": 0
}
]
},
"surfaceWater": {
"riskLevel": "none",
"count": 0,
"details": []
},
"reservoir": {
"riskLevel": "none",
"count": 0,
"details": []
},
"coastalErosion": {
"riskLevel": "none",
"count": 0,
"details": []
},
"coastalGroundInstability": {
"riskLevel": "none",
"count": 0,
"details": []
},
"historicFlooding": {
"riskLevel": "none",
"count": 0,
"details": []
},
"floodDefences": {
"riskLevel": "low",
"count": 1,
"details": [
{
"name": "Fictional Flood Wall",
"distanceMetres": 85
}
]
}
},
"elevation": {
"metres": 12.3,
"source": "OS Terrain 50",
"resolutionMetres": 50
}
}
}Authentication, parameters, billing headers and response schemas are also published in the machine-readable OpenAPI documents in JSON and YAML.