postio_

Which UK address lookup API suits an ecommerce checkout?

How to choose a UK address lookup API for an ecommerce checkout: PAF coverage, postcode lookup versus autocomplete, mobile UX checks, WooCommerce and React routes, and testing on real orders before launch.

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

  1. Get an API key. Every endpoint is a GET returning JSON, with the key in an x-api-key header.
  2. 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/react with PostioProvider and AddressFinder.
  • Anything else: call the JSON API; SDKs exist for Python, Go, PHP, Ruby and .NET.
  1. 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

CheckWhat to ask
DatasetWhich postal file, and is it licensed directly from Royal Mail?
CoverageUK, BFPO, or other countries too?
CapturePostcode list, type-ahead, or both?
ResolveDoes a suggestion resolve to one delivery point with a stable ID?
MobileSuggestions after how many characters? Keyboard support? Manual fallback?
BillingPer 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.

QUESTIONS

Straight answers.

Do I need a Royal Mail PAF licence of my own to use Postio?

No. You use the PAF data under Postio's licence and accept Royal Mail's end-user terms. Postio is a licensed Royal Mail PAF Solutions Provider, and PAF itself belongs to Royal Mail.

Should a checkout use postcode lookup or autocomplete?

Postcode lookup is the simpler pattern: the customer enters a full postcode and picks from every address on it. Autocomplete is friendlier on a phone but harder on speed and ranking. Postio does both from one API, so you can offer type-ahead with the postcode list behind it.

Does Postio work with WooCommerce?

Yes. Install the Postio plugin from WordPress.org and paste your API key under Settings → Postio. It covers the block checkout, the classic checkout and My Account addresses, with type-ahead or postcode lookup as a single setting, and billing and shipping addresses get their own lookup.

Does Postio cover addresses outside the UK?

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

Can I validate email and phone numbers from the same account?

Yes, and it is optional. Email validation runs five checks in one call and phone validation covers UK mobiles and landlines with a live network lookup that returns the carrier. Neither is needed to capture a delivery address.

Ready in under a minute.

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