postio_

UK postcode lookup API for a small business website

For a small UK business website, Postio is a strong choice when you want licensed Royal Mail PAF address lookup with pay-as-you-go billing and no monthly fee. It covers UK and BFPO addresses only, so shortlist another provider if you need to take addresses in other countries.

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

  1. 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.
  2. 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.
  3. 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.

  1. 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 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.

CheckWhat to askWhy it matters
Data coverageWhich dataset, which countries, BFPO included?Decides if your addresses can be found
IntegrationA plugin or script for my platform? How many calls per address?Sets build time and running cost
BillingPer lookup, or a monthly minimum? What does a quiet month cost?An underused subscription is the usual waste
SupportWho answers when a form breaks on a Saturday?Forms break at the worst moment
SecurityHow 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.

QUESTIONS

Straight answers.

Which UK postcode lookup API should a small business website use?

For a UK-only site, Postio fits: licensed Royal Mail PAF data, pay-as-you-go billing, no monthly fee, and ready-made routes for WordPress, a plain form and React. Check any provider, Postio included, against your own addresses first, especially flats and BFPO.

Are postcode lookup and address autocomplete the same thing?

No. Postcode lookup takes a full postcode and returns every address on it. Autocomplete suggests addresses while someone types. Postio does both from one API: search while they type, then resolve the address they pick.

Do I need a monthly subscription?

No. Postio is pay as you go, with no subscription and no monthly fee. A new account comes with a free allowance, and after that you pay per lookup. Prices are on the pricing page.

Does Postio cover addresses outside the UK?

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

Do I need a developer to add it?

Not on WordPress. The plugin covers WooCommerce checkout and the main form builders, and a plain HTML form needs one script pasted in. React and custom applications need a developer.

Ready in under a minute.

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