UK Postcode Lookup API

Overview

The UK Postcode Lookup API lets you search for addresses using a full or partial UK postcode. Each request returns a list of matching addresses with street, city, county, and postcode fields. The database covers all 1.6 million UK postcodes.

How It Works

GET /api/postcode?search={postcode}&apiKey={key}

Returns a JSON array of address objects matching the postcode.

Example Response

{
  "results": [
    {
      "addressLine1": "1 High Street",
      "addressLine2": "",
      "city": "London",
      "county": "Greater London",
      "postcode": "EC1A 1BB"
    },
    {
      "addressLine1": "2 High Street",
      "addressLine2": "Floor 3",
      "city": "London",
      "county": "Greater London",
      "postcode": "EC1A 1BB"
    }
  ],
  "tokensUsed": 1,
  "resultCount": 2
}

Use Cases

Address autocomplete on registration forms
Delivery address validation at checkout
CRM data cleansing and enrichment
Candidate/client address capture in recruitment software

Quick Facts

Token Cost
1 token / 10 results
Billing Rule
ceiling(results ÷ 10)
Zero Results
0 tokens charged
Coverage
1.6M UK postcodes
Format
JSON REST API
Auth
API key (query param)
Documentation
Swagger / OpenAPI

Get Started