API reference

Property flags

Batch-check full UK postcodes for planning history without turning incomplete evidence into a property verdict.

POST/property/flags

Accepts up to 100 unique full postcodes and returns a result for every requested postcode.

Request

POST /property/flags
Content-Type: application/json

{
  "postcodes": ["DA2 7GA", "N1 1AA"]
}

Response shape

{
  "data": [{
    "postcode": "DA2 7GA",
    "postcodeNormalized": "DA27GA",
    "hasPlanningHistory": true,
    "hasRefusedHistory": false,
    "applicationCount": 7,
    "approvedCount": 4,
    "refusedCount": 0,
    "determinedCount": 4,
    "approvalRatePercent": 100,
    "lastDecisionDate": "2026-05-14",
    "latestApplicationDate": "2026-07-02"
  }],
  "meta": { "requested": 1, "limit": 100 }
}