Postcode & address lookup.
UK postcodes to structured addresses. Super fast.
Full Royal Mail PAF coverage. 30 million addresses, including organisations and multiple-residency. Synced nightly.
Try it on a real postcode.
Type any UK address or postcode, pick a result, and see the exact JSON the API returns — every Royal Mail PAF field, live. Then copy the call in your language.
{
"success": true,
"results": [
{
"address_line_1": "57 Wimpole Street",
"building_number": "57",
"country": "England",
"delivery_point_suffix": "1Y",
"district": "City of Westminster London Boro",
"eastings": 528525,
"latitude": 51.51922791,
"longitude": -0.14898992,
"northings": 181658,
"post_town": "LONDON",
"postcode": "W1G 8YW",
"postcode_inward": "8YW",
"postcode_outward": "W1G",
"postcode_type": "S",
"thoroughfare": "Wimpole Street",
"udprn": 25742215,
"ward": "Marylebone Ward"
}
],
"meta": {
"countResults": 1
}
}import { Postio } from "@postio/node";
const postio = new Postio({ apiKey: process.env.POSTIO_API_KEY });
const hits = await postio.address.search("57 Wimpole Street, W1G 8YW");
const address = await postio.address.udprn(hits.results[0].udprn);
console.log(address.results[0]);Where people use it.
Suggest addresses as users type a postcode — no more hand-typed Line 2 errors.
Verify an applicant's address against the authoritative UK file at onboarding.
Normalise legacy customer records before a deliverability campaign.
Route planning with UDPRN + lat/lng attached to every address.
Every field, documented.
The full field list is in the API reference. Here's the shape you'll be consuming.
| FIELD | TYPE | EXAMPLE |
|---|---|---|
| udprn | number | 25742215 |
| postcode | string | "W1G 8YW" |
| postcode_outward | string | "W1G" |
| postcode_inward | string | "8YW" |
| postcode_type | string | "S" |
| address_line_1 | string | "57 Wimpole Street" |
| address_line_2 | string | — |
| address_line_3 | string | — |
| post_town | string | "LONDON" |
| organisation_name | string | — |
| department_name | string | — |
| building_name | string | — |
| building_number | string | "57" |
| sub_building_name | string | — |
| po_box | string | — |
| thoroughfare | string | "Wimpole Street" |
| dependent_thoroughfare | string | — |
| dependent_locality | string | — |
| double_dependent_locality | string | — |
| delivery_point_suffix | string | "1Y" |
| country | string | "England" |
| district | string | "City of Westminster London Boro" |
| ward | string | "Marylebone Ward" |
| latitude | number | 51.51922791 |
| longitude | number | -0.14898992 |
| eastings | number | 528525 |
| northings | number | 181658 |
Where to go next.
Ready in under a minute.
Sign up, grab a key, paste it in. Your first hundred lookups are on us.