PRODUCTSPOSTCODE & ADDRESS LOOKUP
GET /address

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.

GET/address/search
READY
?q=
API SANDBOX

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.

GET/address/search
● 200 OK
?q=
RESPONSE
{
  "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
  }
}
// npm install @postio/node
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]);
USE CASES

Where people use it.

Checkout autocomplete

Suggest addresses as users type a postcode — no more hand-typed Line 2 errors.

KYC / AML

Verify an applicant's address against the authoritative UK file at onboarding.

CRM hygiene

Normalise legacy customer records before a deliverability campaign.

Logistics

Route planning with UDPRN + lat/lng attached to every address.

RESPONSE SHAPE

Every field, documented.

The full field list is in the API reference. Here's the shape you'll be consuming.

FIELDTYPEEXAMPLE
udprnnumber25742215
postcodestring"W1G 8YW"
postcode_outwardstring"W1G"
postcode_inwardstring"8YW"
postcode_typestring"S"
address_line_1string"57 Wimpole Street"
address_line_2string
address_line_3string
post_townstring"LONDON"
organisation_namestring
department_namestring
building_namestring
building_numberstring"57"
sub_building_namestring
po_boxstring
thoroughfarestring"Wimpole Street"
dependent_thoroughfarestring
dependent_localitystring
double_dependent_localitystring
delivery_point_suffixstring"1Y"
countrystring"England"
districtstring"City of Westminster London Boro"
wardstring"Marylebone Ward"
latitudenumber51.51922791
longitudenumber-0.14898992
eastingsnumber528525
northingsnumber181658

Ready in under a minute.

Sign up, grab a key, paste it in. Your first hundred lookups are on us.