Short answer
Postio fits a small UK site that wants postcode lookup and type-ahead search from one JSON API, with a WordPress plugin, a drop-in address finder and a React component already written. Its limit is coverage: UK and BFPO addresses only. If you sell abroad, you need multi-country data instead of Postio, or alongside it.
Who this guide is for
You run a small UK business, or you look after its website, and you want customers to enter a delivery address without mistakes. The usual jobs are a checkout, a booking form or a quote request.
How to add postcode lookup with Postio
- Sign up and copy your API key. The authentication docs show where it goes. A new account comes with a free allowance to test with.
- Pick your route. On WordPress, install the Postio plugin from WordPress.org; it covers WooCommerce and the main form builders. On a plain site, add the drop-in address finder. On React, use the React component. Anything else calls the JSON API.
- Make two calls: search while the user types, then resolve the one they pick.
GET https://api.postio.co.uk/v1/address/search?q=57+wimpole
GET https://api.postio.co.uk/v1/address/udprn/{udprn}Send the key in an x-api-key header. The address docs list every parameter and field.
- Run the test below before you go live.
What a postcode lookup API returns
Give it a full postcode and you get every delivery point on it: building number or name, any flat or unit, the street, the post town and the postcode, each with a UDPRN, Royal Mail's identifier for that address. Postio adds coordinates and the ONS district and ward. There is no county field, on purpose: Royal Mail took the postal county out of PAF in 2000.
Postcode lookup or type-ahead search?
Postcode lookup asks for a full postcode and lists the addresses on it. Type-ahead search lets someone type a house number, street or company name and shows suggestions as they go. Woosmap draws the same line, calling postcode lookup simple and predictable and autocomplete friendlier but more demanding on speed and ranking (Woosmap, "UK Address Lookup API: How to Choose One", 2026).
Most small sites end up with both: search first, the postcode list as a fallback. With Postio the typing is free and the resolve is the billable step, and a valid postcode with no delivery points comes back empty and is not charged.
Why licensed Royal Mail PAF data matters
PAF is the list of UK postal delivery points that Royal Mail maintains and updates. If Royal Mail does not deliver somewhere, it is not in PAF, so a lookup built on PAF will not offer it. For UK delivery that is the right set: addresses that receive mail. Woosmap calls PAF the practical baseline that most serious providers licence, so ask what a provider adds beyond it (Woosmap, 2026).
Postio is a direct Royal Mail PAF licensee. Because PAF is postal, not a property register, very new builds and some sub-divided units can be missing, and you get address text rather than a coordinate per building.
The buying checks that matter
APITier's comparison of UK postcode lookup APIs judges providers on accuracy, ease of use, pricing structure, support and security (APITier, 12 January 2023). Those five work as a checklist.
| Check | What to ask | Why it matters |
|---|---|---|
| Data coverage | Which dataset, which countries, BFPO included? | Decides if your addresses can be found |
| Integration | A plugin or script for my platform? How many calls per address? | Sets build time and running cost |
| Billing | Per lookup, or a monthly minimum? What does a quiet month cost? | An underused subscription is the usual waste |
| Support | Who answers when a form breaks on a Saturday? | Forms break at the worst moment |
| Security | How is the key stored, and what happens to the addresses typed? | Customer addresses are personal data |
How to test with real addresses
Spend an hour on this first.
- A flat in a converted house, where the flat number sits apart from the building number. Check it has its own field (Postio returns
sub_building_name), not glued onto the street line. - A business address with a company name, to see the organisation field filled in.
- The same postcode typed three ways: with the space, without it, in lower case.
- A BFPO address, if you post to forces addresses.
- A postcode with nothing on it, such as a new development. You want an empty result, not an error.
Then print a label with what came back and check the address survives the trip.
When Postio is a good fit
- Your forms take UK and BFPO addresses only.
- You want pay as you go, with no subscription and no monthly fee, on one account for addresses, emails and phone numbers.
- You use WordPress, a plain HTML form or React, and would rather not write the integration.
- You are happy with one JSON API, with SDKs for Python, Go, PHP, Ruby and .NET when you need them.
When to consider another provider
- You take addresses outside the UK and BFPO, so you need multi-country data, instead of Postio or alongside it.
- You need a coordinate per building rather than per postcode. Postio returns the postcode's coordinates; for door-level routing or distance sorting, ask for rooftop geocoding (Woosmap, 2026).
- You must reach every property, including new builds and units that are not yet delivery points. That needs AddressBase or UPRN-grade data (Woosmap, 2026).
- You want maps, distance and routing in one contract. Location platforms bundle those; a PAF specialist does not.
Next step
Start with the 100 free lookups, run the test above on your own addresses, then see pricing once you know your monthly volume. Postio's address page sums up the product.