Docs/Address Lookup/Postcode Lookup

Postcode Lookup

GEThttps://property-api.k8s.outra.co.uk/api/v2/address-lookup/postcode
API keyJSON

Return all properties for a given UK postcode from the geographic dataset. Accepts postcodes with or without a space (for example SW1A 2AA or SW1A2AA); the input is normalised to uppercase with a single space before the inward code. Returns up to 500 matching properties.

Purpose

  • Postcode → properties — enumerate every property (UPRN + address) in a postcode.
  • Flexible input — accepts spaced or unspaced postcodes and normalises them.
  • Lightweight — returns just the four fields needed to identify and label a property.

Parameters

NameTypeRequiredDescription
postcodestringRequiredUK postcode to look up. Accepts with or without a space. Examples: SW1A 2AA, SW1A2AA, EC1A1BB. Length 5–8.
bash
curl 'https://property-api.k8s.outra.co.uk/api/v2/address-lookup/postcode?postcode=SW1A 2AA' \
  -H 'accept: application/json' \
  -H 'Authorization: Api-Key {api_key}'

Status codes

CodeDescription
200Successful postcode lookup
401Unauthorised – missing or invalid API key
422Invalid postcode format
429Rate limit exceeded

A 422 returns a detail message:

json
{ "detail": "Invalid UK postcode format" }

Field reference

Returned fieldsADDRESS LOOKUP
UPRN
Unique Property Reference Number.
ADDRESS
Full single-line address.
POST_TOWN
Post town.
POSTCODE
Normalised postcode.

Typical use cases

Address pickers

Populate an address selector once a user enters a postcode.

UPRN discovery

Resolve a postcode to its UPRNs before deeper enrichment.

Coverage checks

Enumerate the properties present in a given postcode.