The AutoPostcode address API documentation is a developer hub covering the quickstart, authentication and full REST reference for UK address lookup. Every endpoint returns real addresses matched against Royal Mail PAF — around 31 million deliverable addresses across roughly 1.8 million postcodes — as JSON, typically in under a second.
How do I make my first request?
Get an API key, then call the lookup endpoint with a postcode and your bearer token. Here it is with cURL:
curl "https://api.autopostcode.com/v1/lookup?postcode=SW1A1AA" \
-H "Authorization: Bearer YOUR_API_KEY"Or from JavaScript with the Fetch API:
const res = await fetch(
"https://api.autopostcode.com/v1/lookup?postcode=SW1A1AA",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const { addresses } = await res.json();Full parameters and response fields are in the REST API reference.
Where should I start?
New to the API? Begin with the quickstart to make your first call, then read authentication and keys to secure and rotate your credentials.
- Quickstart — first successful lookup
- Authentication & keys — bearer tokens and rotation
- REST reference — every endpoint and field
- Rate limits & error handling — production hardening
Ready to build?
Grab a key and read the docs — most teams are returning live PAF addresses within minutes.
Frequently asked questions
Where is the address API documentation?
The AutoPostcode address API documentation is organised as a hub: a quickstart to make your first call, an authentication guide for API keys, and a full REST reference. Every endpoint returns real UK addresses matched against Royal Mail PAF — around 31 million deliverable addresses across roughly 1.8 million postcodes.
How do I make my first API call?
Get an API key, then send a GET request to the lookup endpoint with a postcode and your bearer token. You receive matching addresses as JSON in under a second. The quickstart walks through it step by step.
How does authentication work?
Requests are authenticated with a bearer API key sent in the Authorization header. Keys are managed from your dashboard and can be rotated at any time — see the authentication and keys guide.
What format does the API return?
The API returns JSON, with each result containing standardised PAF fields such as building name/number, thoroughfare, locality, post town and postcode.
Are there code examples?
Yes. The docs include copy-paste examples for JavaScript, cURL and other languages, plus no-code plugins for Shopify, WooCommerce and WordPress.
What data source does the API use?
Every lookup is matched against Royal Mail PAF, the official and continuously updated record of deliverable UK addresses, so results are authoritative and current.
Ready to get started?
Add Royal Mail PAF-verified UK address lookup to your site in minutes — start free, no card required.