Address Search

GET1 credit

GET/addresses/search

Typeahead fuzzy-search UK addresses and resolve them to canonical UPRNs.

Overview

Ranked fuzzy search against 63M+ UK addresses (Ordnance Survey AddressBase Plus) using trigram similarity.

Returns up to 50 ranked matches with coordinates and similarity scores. Sub-200ms p95.

Why this endpoint exists

UPRN is the canonical UK property identifier — the key that unlocks the rest of the PMI API.

Licensing AddressBase Premium from Ordnance Survey starts at ~£10,000/year and requires GIS infrastructure. This endpoint gives you it on a pay-per-call basis.

Query parameters

qstringRequired

Search string, minimum 2 characters.

limitintegerOptional · default 10

Max results. Capped at 50.

Response Schema

results

Array of { uprn, address, postcode, latitude, longitude, score }.

count

Integer — total results returned.

Example

RequestLive key

curl -G https://pmi-api-beta-7tvvt.ondigitalocean.app/v1/addresses/search \
  --data-urlencode "q=12 bennett road ls6" \
  --data-urlencode "limit=5" \
  -H "Authorization: Bearer pmi_live_xxxxxxxxxxxxxxxx"

Try this endpoint with your own key

100 free credits, no card required.

Response200 OK

{
  "results": [
    {
      "uprn": 72226528,
      "address": "12 BENNETT ROAD, LEEDS, LS6 3HN",
      "postcode": "LS6 3HN",
      "latitude": 53.8197,
      "longitude": -1.572,
      "score": 0.82
    }
  ],
  "count": 1
}

More about this endpoint

Use Cases

Power an autocomplete box in a signup form, valuation request, or deal-sourcing UI.

Clean user-typed addresses before hitting a downstream endpoint — every other endpoint keys off uprn or postcode.

Find a property when you only know a partial address like "12 Bennett Road, LS6".