Postcode lookup

List every address at a UK postcode (Royal Mail PAF)

Returns every delivery point at a given UK postcode, backed by the official Royal Mail Postcode Address File (PAF). UK-only (country: "gbr"). Each address carries the Royal Mail udprn, the Ordnance Survey uprn (with its uprn_match_m match distance), the full printable PAF element set (post_town, dependent localities, address_lines, administrative_county), and rooftop coordinates when available.

UK host: call this endpoint on https://paf.acuris-geo.com. Requests sent to api.acuris-geo.com return 400 {"error": "country_not_served_by_this_endpoint", "use_instead": "https://paf.acuris-geo.com"}.

Charges 1 validation transaction per call, regardless of how many addresses are returned. Anonymous callers use the free tier (per-IP daily cap). The number of addresses returned is capped (default 100); when the cap is hit the response sets truncated: true. A per-IP velocity cap also applies to protect the licensed dataset.

post/postcode-lookup

Request

  • Base URL: https://api.acuris-geo.com
  • URL: https://api.acuris-geo.com/postcode-lookup
  • Auth: one of:
    • API key in header X-Acuris-Key
    • HTTP bearer
    • API key in header X-API-Key
    • API key in query parameter key
    • none

Request body

postcodestring required
countrystring

Only gbr is supported.

Example request

{
  "postcode": "SW1A 2AA"
}

Response

All addresses at the postcode.

postcodestring
countrystring
countinteger
truncatedboolean

Present and true when the result set was capped.

validation_credits_remaininginteger

Present only for authenticated (keyed) callers. Omitted for anonymous free-tier requests.

geocode_credits_remaininginteger

Present only for authenticated (keyed) callers. Omitted for anonymous free-tier requests.

Changes

No recorded changes to this operation across all 1 revision of this API.