Short answer
For UK address validation, choose an API built on licensed Royal Mail PAF data that does both type-ahead search and full address lookup. Postio is a licensed Royal Mail PAF Solutions Provider with UK and BFPO coverage, UDPRN lookup and pay-as-you-go billing, which makes it a straightforward fit for UK websites and apps.
Who this guide is for
You are choosing an API to validate UK addresses: on a checkout, a booking or sign-up form, or in a back office where imported addresses need checking. The criteria below decide it, whichever provider you end up with.
What UK address validation means
Validation happens at two moments, from one dataset.
At capture, the customer picks a real delivery point instead of typing a free-text address. That is where most bad addresses are prevented rather than fixed later.
At postcode level, you take a full postcode and get every delivery point on it. That copes with a block of flats, and it is the check to run on an address you already hold.
Validation and autocomplete are not rival approaches. Autocomplete is how someone finds the right delivery point; validation is confirming that the point you store is one Royal Mail delivers to. Both come from the same postal file, which is why the data source matters more than the interface.
Why licensed Royal Mail PAF data matters
PAF is Royal Mail's file of UK postal delivery points. Ask any provider whether it licences PAF directly from Royal Mail, and how often the data is refreshed: a stale copy drifts away from what Royal Mail actually delivers to, and no amount of clever matching fixes that.
You do not need a PAF licence of your own to use Postio. You use the data under Postio's licence and accept Royal Mail's end-user terms, which are published in full at PAF end user terms. Read them before you sign anything off, because they set out what you may do with the addresses you store.
Type-ahead search, every address at a postcode, UDPRN
Postio exposes the lookups separately, so you can pick the right one for each screen.
- Search as they type.
/v1/address/search?q=...returns audprnand a one-line label for each suggestion. - Every address at a postcode.
/v1/address/postcode/{postcode}returns the delivery points on that postcode, for a dropdown after someone types it in full. - Resolve one delivery point.
/v1/address/udprn/{udprn}returns the full PAF record: address lines, post town, organisation,sub_building_namefor a flat or unit, and postcode.
Keep the UDPRN with the address you save. It identifies that delivery point, so you can resolve it again later without asking the customer to retype anything. The address docs list every parameter and field.
Coverage, and why there is no county
Postio covers UK and BFPO addresses, and nothing else. If you take addresses outside the UK, you need a provider with multi-country coverage, alongside Postio or instead of it.
There is no county field, on purpose: Royal Mail no longer uses counties, so post town and postcode carry the delivery. Don't add a county back into your schema expecting the API to fill it.
How to add it to a UK site
- Sign up and put your key in an
x-api-keyheader. Every endpoint is a GET returning JSON. - Pick the route for your stack. A plain HTML form takes the drop-in Address Finder: one script tag and a combobox with keyboard navigation. WordPress sites take the plugin, which covers WooCommerce checkout and the main form builders. React has a component, and there are npm packages, a CLI, an MCP server and SDKs for Python, Go, PHP, Ruby and .NET.
- Call search while the customer types, then resolve the suggestion they pick:
GET https://api.postio.co.uk/v1/address/search?q=57+wimpole
GET https://api.postio.co.uk/v1/address/udprn/50905588- Test on your own addresses before going live: a flat in a converted house, a rural address where the locality matters, a business address, a street finished this year, and the same postcode typed with a space, without one, and in lower case.
Buyer checklist
| Check | What to ask |
|---|---|
| Data source | Which postal file, and is it licensed directly from Royal Mail? |
| Coverage | UK only, BFPO, or other countries too? |
| Response structure | Does a suggestion resolve to one identified delivery point you can store and re-resolve? |
| Awkward addresses | Do the flat or unit and the locality come back in their own fields? |
| Integration | Plugin, drop-in script or SDK for your stack, or JSON to build against? |
| Billing | Pay as you go, or a monthly minimum you pay in a quiet month? |
Where Postio fits
Postio is a UK validation API for addresses, emails and phone numbers, on one account and one JSON API. The address product page is the short version. It suits UK websites and apps that want a licensed PAF source, both capture methods and pay-as-you-go billing. It does not suit multi-country address capture.
Next step
Start with the 100 free lookups, run the test addresses above, then read the address documentation for the fields you will store. Billing details are on pricing.