Stratum
Start
API reference · version 0.1.0

UK Postcode Intelligence

Crime, flood zone, radon, coal mining, landfill and knotweed records for a UK postcode in one API call.

Base address
https://api.stratumapis.com/v1/postcode
Your key
The X-Stratum-Key header, with the key from your API page. Paid per call from your API balance, with no plan (add money on your API page).
Prices
  • A postcode (its risk profile, neighbourhood index or crime forecast)10p (5p from 1,000 a month)
  • A bulk request10p for each postcode found
Every reply carries X-Stratum-Credit-Balance-Pence; a refusal or a source failure is never charged. Limits and prices.
OpenAPI
Download the OpenAPI file (JSON)

Endpoints

gethttps://api.stratumapis.com/v1/postcode/{postcode}

Get enriched intelligence for a UK postcode

Parameters
  • postcoderequiredin path
Example request
curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/postcode/SW1A1AA"
Errors
  • 400 Invalid postcode format
  • 401 Missing or invalid API key
  • 404 Postcode not found in our reference data
  • 500 Internal error
posthttps://api.stratumapis.com/v1/postcode/bulk

Bulk lookup up to 100 postcodes in one request (Growth+)

Example request
curl -X POST -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/postcode/bulk"
Request body
{
  "type": "object",
  "required": [
    "postcodes"
  ],
  "properties": {
    "postcodes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100
    }
  }
}
Errors
  • 400 Invalid request body
  • 401 Missing or invalid API key
gethttps://api.stratumapis.com/v1/postcode/{postcode}/neighbourhood-index

Composite neighbourhood index, A-F band per LSOA

W30 iter 8. Returns the iter-5-design composite score from 12 weighted inputs (crime rate / trend / forecast / IMD income / IMD employment / population density / tenure PRS / price-paid trend / flood / MEES / radon / coal). Score 0-1 (0=best), bucketed into 6 equal-width bands. Missing inputs degrade gracefully and surface in the missing array. Radon comes from the BGS / UKHSA radon atlas since 2026-10-10 and coal from the Mining Remediation Authority since 2026-10-04.

Parameters
  • postcoderequiredin path
Example request
curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/postcode/:postcode/neighbourhood-index"
Errors
  • 404 Postcode not recognised
gethttps://api.stratumapis.com/v1/postcode/{postcode}/crime-forecast

3-month direction-band crime forecast per category

W30 iter 7 + iter 9 standalone exposure. Reads the per-(outcode, category) Holt-Winters direction-band rows the weekly forecast cron writes. Returns one row per display category. Surfaces rising / stable / declining per W30 iter-7 honest- presentation decision (we don't claim exact-count accuracy).

Parameters
  • postcoderequiredin path
Example request
curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/postcode/:postcode/crime-forecast"
Errors
  • 404 Postcode not recognised