UK Postcode Validator & Enricher

Validate and enrich UK postcodes with full geographic, administrative, political, and health data — using the free postcodes.io API. No API key required.

Built for data teams, CRM enrichment, lead generation, and compliance workflows.

---

What You Get

For each postcode, the actor returns:

Field	Description
postcode	Formatted postcode
status	VALID or INVALID
latitude / longitude	GPS coordinates
region	e.g. London, North West, Yorkshire
country	England, Scotland, Wales, Northern Ireland
district	Local authority / council district
county	County (where applicable)
ward	Electoral ward
constituency	UK Parliamentary constituency
constituency2024	Updated 2024 boundary constituency
nhsRegion	NHS Health Authority region
ccg	Clinical Commissioning Group
lsoa	Lower Super Output Area code
msoa	Middle Super Output Area code
outcode	Outward code (e.g. SW1A)
incode	Inward code (e.g. 1AA)
codes	Raw ONS/GSS codes for all fields

---

Input

{
  "postcodes": ["SW1A 1AA", "EC1A 1BB", "M1 1AE"],
  "useBulkApi": true
}

Parameter	Type	Description
postcodes	String[]	List of UK postcodes to process
useBulkApi	Boolean	Process in batches of 100 (recommended for large lists, default: true)
requestDelayMs	Integer	Delay between requests in ms (default: 100)

Postcodes are case-insensitive and spaces are handled automatically — sw1a1aa, SW1A1AA, and SW1A 1AA all work.

---

Example Output

{
  "postcode": "SW1A 1AA",
  "status": "VALID",
  "latitude": 51.501009,
  "longitude": -0.141588,
  "region": "London",
  "country": "England",
  "district": "Westminster",
  "county": null,
  "ward": "St James's",
  "constituency": "Cities of London and Westminster",
  "constituency2024": "Cities of London and Westminster",
  "nhsRegion": "London",
  "ccg": "NHS North West London",
  "lsoa": "Westminster 018C",
  "msoa": "Westminster 018",
  "outcode": "SW1A",
  "incode": "1AA",
  "codes": {
    "adminDistrict": "E09000033",
    "adminWard": "E05013806",
    "constituency": "E14000639",
    "lsoa": "E01004736",
    "msoa": "E02000977"
  }
}

---

Use Cases

• CRM Enrichment — append region, district, and constituency to customer records
• Lead Scoring — segment leads by region, area deprivation (LSOA), or constituency
• Data Validation — clean and validate postcode lists before mailing or outreach
• Geographic Analysis — map customers by ward, district, or NHS region
• Compliance — verify UK addresses for KYC and onboarding workflows
• Political Targeting — identify constituency for voter outreach or canvassing

---

Performance

The actor uses the postcodes.io bulk API to process up to 100 postcodes per request, making large list enrichment fast and efficient. A list of 10,000 postcodes typically completes in under 2 minutes.

---

Data Source

All data is sourced from postcodes.io, which is built on Ordnance Survey, ONS, and Royal Mail open data. The API is free, open, and publicly accessible — no registration required.

---

Pricing

$1.00 per 1,000 results + $0.05 per actor start

---

Combine With

Pair this actor with the Companies House Enricher (insulin_junkie/companies-house-enricher) or FCA Register Scraper (insulin_junkie/fca-register-scraper) to add full geographic context to your UK business data.