Location intelligence

Environmental Risk API for Environmental Searches

Screen flood, indicative radon potential, noise, landfill, coal mining, invasive plants, current air quality and groundwater-protection factors without ordering paid data.

Environmental risk API endpoint

GET/api/v1/property/environmental-risk

Provide postcode, or both latitude and longitude. Radon is a conservative 1 km indicative atlas result. Historic landfill is a 250 metre proximity flag for England, while its conditional licence is current, and for Wales. Strategic noise covers England, Wales and Scotland. Source protection zones cover England and Wales. Authorised landfill is outside the factor. Official reports are still recommended.

Geographic availability

Coverage by UK nation

Green: supported Amber: partial Red: not supported

The colour is a geographic coverage indicator, not a risk score. Always inspect source status and completeness in the API response.

England

Partial

Flood, indicative radon, coal, BGS ground context, strategic noise, source-protection zones, EA storm overflow annual returns and UK-AIR are configured. Landfill and invasive plants remain unresolved.

Wales

Partial

Welsh flood mapping, indicative radon, coal/BGS context, Welsh Government Round 4 road and rail noise, NRW source-protection zones, NRW historic landfill and UK-AIR are configured. Storm overflows return not_covered.

Scotland

Partial

SEPA river, coastal and surface-water flood maps, indicative radon, coal/BGS context, Scottish Round 4 road and rail noise and UK-AIR are configured. Scotland has no source-protection zones or national historic landfill dataset, so those factors return not_covered. Storm overflows also return not_covered.

Northern Ireland

Very limited

Indicative radon and nearest UK-AIR context are configured. Flood and ground sources are not configured.

Cost per successful request

Pricing

A successful request costs 5–20 credits according to the factors selected. No official environmental search is ordered.

API credits
5–20 credits

The selected live source groups determine the price. The response and X-Credit-Cost header show the applied amount.

Rejected or failed
No charge

Handler errors are not charged. A successful partial screen is charged.

What the API provides

Stable factor model

Always distinguishes matched, clear, unavailable, not_covered and licence_required. Missing data is never reported as no risk.

  • flood
  • radon
  • noise
  • landfill
  • coal_mining
  • invasive_plants
  • air_quality_today
  • groundwater_source_protection
  • storm_overflows

Open-data evidence

Returns flood and coal screens, the BGS and UKHSA 1 km indicative radon atlas, modelled road and rail Lden noise for England, Wales and Scotland, Source Protection Zones for England and Wales, the nearest current UK-AIR station reading and storm overflows within 1 km in England with their latest annual spill count and hours.

Honest gaps

Radon and historic landfill are explicitly indicative and direct callers to official reports. Historic landfill can flag an England or Wales site within 250 metres. The England data also needs an active conditional licence. Scotland has no source-protection zones or national historic landfill dataset, so those factors return not_covered. Authorised landfill is outside the factor, and invasive plants remain unavailable.

Selective response

Use factors=all or a comma-separated subset. Unrelated source groups are not called, and each returned factor has only status, riskLevel and useful details.

Response guide

FieldMeaning
data.locationResolved property location and search radius.
data.completeTrue only when every requested factor was resolved. Licence-required and unavailable factors make this false.
data.riskLevelHighest risk level across matched factors.
data.factorsRequested factor keys with a concise status, risk level and useful details or note.

Useful request variants

Return every factor

curl -X GET "https://propertyinsights.co.uk/api/v1/property/environmental-risk?postcode=ZZ1%201ZZ&factors=all" \
  -H "x-api-key: YOUR_API_KEY"

Only flood, noise and today’s air quality

curl -X GET "https://propertyinsights.co.uk/api/v1/property/environmental-risk?latitude=52.123&longitude=-1.234&factors=flood,noise,air_quality_today" \
  -H "x-api-key: YOUR_API_KEY"

Not included

  • Historic landfill is a 250 metre proximity flag for England and Wales after the private import. Scotland and Northern Ireland are not covered. Authorised landfill is not included.
  • An official address-level radon report, Groundwater vulnerability, BGS GeoSure and BGS groundwater-flood susceptibility are not included.
  • The invasive-plants status is unavailable. A Japanese knotweed or other invasive-species conclusion requires property evidence and usually a site survey.
  • Strategic noise is modelled, and today’s air quality is from the nearest station rather than the property.
  • Storm overflows use the Environment Agency annual return for England only and are updated once a year. Wales, Scotland and Northern Ireland return not_covered. Spill records show when an overflow discharged, not water quality.
  • Contaminated-land registers remain fragmented across local authorities.
  • This is not an environmental search, contaminated-land conclusion or groundwater assessment.

Billing details in the response

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 headerMeaning
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.

When credits run out

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"
    }
  }
}

Environmental risk API parameters

NameRequiredTypeDescription
postcodeNostringFull UK postcode. Alternatively provide coordinates.
latitudeNonumberLatitude when postcode is omitted.
longitudeNonumberLongitude when postcode is omitted.
radiusMetresNointegerFlood-defence and ground search radius from 25 to 2,000 metres. Defaults to 250.
factorsNostringComma-separated factor names or all. Defaults to all.

Source and coverage

Source
Environment Agency, Natural Resources Wales, Welsh Government, Scottish Government, Defra UK-AIR, Mining Remediation Authority, British Geological Survey and UK Health Security Agency
Coverage
Source-specific UK, Great Britain, England, Wales and Scotland coverage

Inspect each factor status. unavailable, not_covered and licence_required are not negative risk results.

Example request

curl -X GET "https://propertyinsights.co.uk/api/v1/property/environmental-risk?postcode=ZZ1%201ZZ&factors=all" \
  -H "x-api-key: YOUR_API_KEY"

Example response

{
  "success": true,
  "data": {
    "location": {
      "postcode": "ZZ1 1ZZ",
      "country": "england",
      "latitude": 52.123,
      "longitude": -1.234,
      "radiusMetres": 250
    },
    "coverage": "england-plus-uk-air-monitoring",
    "complete": false,
    "riskLevel": "medium",
    "factors": {
      "flood": {
        "status": "matched",
        "riskLevel": "medium",
        "details": {
          "matchedRisks": [
            "riversAndSea"
          ]
        }
      },
      "radon": {
        "status": "matched",
        "riskLevel": "medium",
        "details": {
          "affectedArea": true,
          "officialReportRecommended": true,
          "probabilityBand": "5% to less than 10%",
          "gridSquare": "SP1234",
          "datasetVersion": "Radon Indicative Atlas GB v3",
          "coverage": "great-britain",
          "resolutionMetres": 1000,
          "indicative": true
        },
        "note": "Indicative 1 km-grid screening flag only, not a property or site report. Obtain an official address-level radon report for definitive detail; only a property measurement can establish the actual radon level."
      },
      "noise": {
        "status": "clear",
        "riskLevel": "none"
      }
    }
  }
}

OpenAPI specification

Authentication, parameters, billing headers and response schemas are also published in the machine-readable OpenAPI documents in JSON and YAML.