United Kingdom Postal Code API

About United Kingdom postcodes

The UK uses alphanumeric postcodes in outcode + incode format. The outcode (e.g., SW1A) identifies the postal district; the incode (e.g., 1AA) narrows to a group of addresses. London codes start with E, EC, N, NW, SE, SW, W, WC.

Local term: postcode | Regex pattern: ^[A-Z]{1,2}\d[A-Z\d]?\s?\d[A-Z]{2}$

API Usage Examples

curl -X POST https://postaldatapi.com/api/lookup \
  -H "Content-Type: application/json" \
  -d '{"zipcode": "SW1A 1AA", "country": "GB", "apiKey": "YOUR_API_KEY"}'

from postaldatapi import PostalDataPI

client = PostalDataPI(api_key="YOUR_API_KEY")
result = client.lookup("SW1A 1AA", country="GB")
print(result.place_name, result.latitude, result.longitude)

import { PostalDataPI } from 'postaldatapi';

const client = new PostalDataPI({ apiKey: 'YOUR_API_KEY' });
const result = await client.lookup('SW1A 1AA', { country: 'GB' });
console.log(result.placeName, result.latitude, result.longitude);