UK AUTOCOMPLETE · ROYAL MAIL PAF

Your customer types three letters. We finish the address.

Type-ahead over the official Royal Mail PAF — 33.9 million UK delivery points, including flats and sub-buildings. Search by street, by building name, or straight from a postcode. Every selected address returns UDPRN, UPRN and a point coordinate.

Try it live

Start typing a UK address, a building name, or a postcode. This is the same /suggest call your checkout would make — typing is free, only the address you pick is a billable lookup.

UK Autocomplete

UK only — live Royal Mail PAF suggestions from our dedicated UK endpoint. No account, no card. Type as much as you like — only selecting an address counts, up to 3 UK selections per day from this browser, shared with our other UK tools on this site; resets daily at midnight UTC. A free account includes 50 UK lookups in its 30-day evaluation.

Two steps, so typing stays free.

Autocomplete is split in two. The list step runs on every keystroke and is free — it returns labels and an opaque id, no coordinates and no components. The retrieve step runs once, when your customer picks an address, and is the only call that counts as a lookup.

# 1. list — free, fires as they type
curl 'https://paf.acuris-geo.com/suggest?country=gbr&q=10+downing&v=2' \
  -H 'X-Acuris-Key: YOUR_KEY'

{"suggestions": [
  { "id": "eyJ2IjozLCJjIjoiZ2Jy…",
    "formatted_address": "10 DOWNING STREET\nLONDON\nSW1A 2AA\nUNITED KINGDOM" }
], "v": 2}

# 2. retrieve — the one billable call, on selection
curl 'https://paf.acuris-geo.com/suggest/retrieve?id=eyJ2IjozLCJjIjoiZ2Jy…' \
  -H 'X-Acuris-Key: YOUR_KEY'

{"address": {
  "street": "DOWNING STREET", "house_number": "10",
  "city": "LONDON", "postcode": "SW1A 2AA",
  "udprn": "23747771", "uprn": "100023336956",
  "lat": 51.503541, "lng": -0.12767
}}

UK autocomplete is served from paf.acuris-geo.com, our dedicated Royal Mail PAF host — a separate endpoint from the 240-country international API.

One endpoint. JSON in, JSON out.

Send a POST request to /postcode-lookup with the postcode and country. UK addresses are served from paf.acuris-geo.com, our dedicated Royal Mail PAF host. The response is a single JSON document with the array of addresses and a count.

Request

# curl
curl -X POST 'https://paf.acuris-geo.com/postcode-lookup' \
  -H 'X-Acuris-Key: YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"postcode":"SW1A 2AA","country":"gbr"}'

Response

{
  "postcode": "SW1A2AA",
  "country": "gbr",
  "count": 1,
  "addresses": [
    {
      "street": "DOWNING STREET",
      "house_number": "10",
      "organisation_name": "PRIME MINISTER & FIRST LORD OF THE TREASURY",
      "city": "LONDON",
      "county": "MIDDLESEX",
      "administrative_county": "WESTMINSTER",
      "dependent_locality": "",
      "double_dependent_locality": "",
      "postcode": "SW1A2AA",
      "lat": 51.503541,
      "lng": -0.12767,
      "accuracy_type": "rooftop",
      "udprn": "23747771",
      "uprn": "100023336956",
      "uprn_match_m": 0.0
    }
  ]
}

What’s not included

Honesty about scope:

  • No PAF redistribution. Our licence covers querying — you can integrate the API into your product, but you can’t bulk-download our PAF data and resell it.
  • Postcode-only Large User addresses — buildings like 10 Downing Street and Buckingham Palace are encoded as postcode-without-street in PAF; those return a postcode-level position, and the response says so.
  • Channel Islands & Isle of Man — covered under separate ISO codes (jey, ggy, imn) on the global API, not the UK product.

Start building UK autocomplete today

Get an API key in under a minute — no credit card. UK (Royal Mail PAF) lookups: 50 are included in your 30-day free evaluation, one allowance rather than a daily figure. This UK allowance is separate from the 1,000 international lookups. After the evaluation, UK lookups continue with a UK pack (from 250 lookups). Anonymous demo: 3 per day.