Short answer
For a UK ecommerce checkout, choose an address lookup API that returns complete Royal Mail PAF addresses, supports the capture pattern your checkout needs, and can be tested on a sample of your own orders before launch. Postio fits UK and BFPO checkouts with postcode lookup, type-ahead search, a WooCommerce-ready WordPress plugin and pay-as-you-go billing with no monthly fee. Shops selling internationally need coverage for every destination.
Who this guide is for
You run a UK shop, or build its checkout, and want delivery addresses right the first time.
Postcode lookup or autocomplete at checkout
Woosmap separates postcode lookup from address autocomplete and says buyers often conflate them (Woosmap, "UK Address Lookup API: How to Choose One", 2026, read 17 November 2026). Postcode lookup takes a full postcode and lists every address on it; Woosmap calls it cheap, predictable and enough for most UK residential deliveries. Autocomplete suggests addresses as the customer types; Woosmap says it reduces form abandonment but is harder on speed and ranking.
Most checkouts want both, with the postcode list as the fallback. Postio does both from one API, and either route ends in a full PAF address.
What licensed Royal Mail PAF data supplies
PAF is Royal Mail's file of UK postal delivery points, roughly 30 million of them, updated daily, and it lists places Royal Mail delivers to rather than every property (Woosmap, 2026). Woosmap says PAF coverage is usually enough for a standard ecommerce checkout.
Postio is a licensed Royal Mail PAF Solutions Provider, built on PAF data licensed directly from Royal Mail, covering UK and BFPO addresses. That suits delivery capture: the customer picks a delivery point Royal Mail will deliver to.
A property that is not yet a delivery point can be missing, so very new builds and some sub-divided units are the usual gaps. Postio returns no county field, on purpose: Royal Mail removed the former postal county from PAF in 2000 (address docs).
Checkout UX checks on mobile
Bullock's trial list covers how many characters a shopper types before useful suggestions appear, and whether flats, rural addresses and new-build streets work (Lilach Bullock, "Address Validation APIs (2026): 10 Options by Country", 2026, read 17 November 2026). On a phone, also check:
- Two or three letters give a usable suggestion for a house number, a street and a business name, and one pick fills the right fields with a flat number apart from the building number.
- Arrow keys move, Enter picks, Escape closes, and the keyboard does not cover the list. Postio's drop-in address finder is an ARIA-compliant combobox with keyboard navigation.
- Manual entry stays available. A lookup that traps a customer on an address PAF does not hold loses the order.
How to add it with Postio
- Get an API key. Every endpoint is a GET returning JSON, with the key in an
x-api-keyheader. - Pick your route:
- WooCommerce: install the Postio plugin from WordPress.org and paste the key under Settings → Postio. The WooCommerce checkout switches on for block and classic checkout and My Account addresses; type-ahead or postcode lookup is one setting.
- Plain HTML: one script tag for the drop-in address finder, about 4 KB gzipped.
- React: the React component,
@postio/reactwithPostioProviderandAddressFinder. - Anything else: call the JSON API; SDKs exist for Python, Go, PHP, Ruby and .NET.
- Search, then resolve what the customer picks:
GET https://api.postio.co.uk/v1/address/search?q=57+wimpole
GET https://api.postio.co.uk/v1/address/udprn/{udprn}Keep the UDPRN with the order so you can resolve that delivery point again later.
Email and phone checks, if you want them
The same account checks email and UK phone numbers, and neither is needed to capture a delivery address. Email validation runs five checks in one call: format, typos, type of address, mail server and mailbox (email product). Phone validation covers UK mobiles and landlines, with a live network lookup that returns the carrier (phone product).
Test on real orders before launch
Bullock advises running a sample of past orders, including the messy ones, and seeing how many get corrected or flagged (Lilach Bullock, 2026). Take fifty to a hundred:
- A flat in a converted house, where the flat number must land in
sub_building_name. - A rural address where the dependent locality carries the delivery.
- A street finished in the last few months.
- An order with a wrong address: a missing house number, a mistyped postcode, a postcode typed without its space.
Billing and operational checks
Postio is pay as you go, with no subscription and no monthly fee, on one account for addresses, emails and phone numbers; prices are on pricing. Whatever you choose, ask what an empty result costs, whether there is a monthly minimum, who answers when checkout breaks on a Saturday, and where the API key is kept. A UK address tied to a named person is personal data, so ask what happens to the addresses customers type and get that in writing (Woosmap, 2026).
Comparison checklist for any provider
| Check | What to ask |
|---|---|
| Dataset | Which postal file, and is it licensed directly from Royal Mail? |
| Coverage | UK, BFPO, or other countries too? |
| Capture | Postcode list, type-ahead, or both? |
| Resolve | Does a suggestion resolve to one delivery point with a stable ID? |
| Mobile | Suggestions after how many characters? Keyboard support? Manual fallback? |
| Billing | Per lookup or a monthly minimum? What does an empty result cost? |
Where Postio fits, and where it doesn't
Postio suits a shop taking UK and BFPO addresses on WooCommerce, a plain form or React, with one account for address, email and phone checks and no subscription. It does not suit a shop that ships internationally: there is no data outside the UK and BFPO, so you need multi-country coverage, instead of Postio or alongside it. Latitude and longitude are the postcode centroid rather than the doorway, so door-level routing needs another tool (address docs).
Next step
Start with the 100 free lookups, run the sample above on your own orders, then check pricing once you know your volume. Postio's address page is the short version; the address docs list every field.