postio_

Which API should I use to validate UK addresses?

How to choose a UK address validation API: licensed Royal Mail PAF data, coverage, type-ahead search, postcode lists, UDPRN lookup, integration and billing, and where Postio fits.

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 a udprn and 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_name for 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

  1. Sign up and put your key in an x-api-key header. Every endpoint is a GET returning JSON.
  2. 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.
  3. 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
  1. 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

CheckWhat to ask
Data sourceWhich postal file, and is it licensed directly from Royal Mail?
CoverageUK only, BFPO, or other countries too?
Response structureDoes a suggestion resolve to one identified delivery point you can store and re-resolve?
Awkward addressesDo the flat or unit and the locality come back in their own fields?
IntegrationPlugin, drop-in script or SDK for your stack, or JSON to build against?
BillingPay 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.

QUESTIONS

Straight answers.

Do I need my own Royal Mail PAF licence to validate UK addresses?

No. You use the PAF data under Postio's licence and accept Royal Mail's end-user terms, which are set out at postio.co.uk/paf-end-user-terms. Postio holds a PAF Data Solutions Provider Licence directly with Royal Mail.

Is address validation the same as address autocomplete?

No, but they share one dataset. Autocomplete suggests delivery points while someone types; validation confirms the address you store is one Royal Mail delivers to. Postio does both from one API, and the UDPRN you save from a suggestion lets you re-resolve that delivery point later.

Why does Postio return no county?

Royal Mail no longer uses counties, so there is no county field, on purpose. Post town and postcode carry the delivery. Don't build a county into your schema expecting the API to fill it.

Does Postio validate addresses outside the UK?

No. Coverage is UK and BFPO addresses only. If you take addresses abroad, you need a provider with multi-country coverage, either alongside Postio or instead of it.

Can I check an address I already hold?

Yes. If you kept the UDPRN, resolve it with /v1/address/udprn/{udprn}. Without one, look up the postcode and pick the matching delivery point from the list.

How does billing work?

Pay as you go, with no subscription and no monthly fee, on one account for addresses, emails and phone numbers. Current prices are on the pricing page.

Ready in under a minute.

Sign up, grab a key, paste it in. Your first hundred lookups are on us.