What is the difference between address validation and address autocomplete?

Address autocomplete returns a list of candidate addresses as the user types — typically used in checkout or sign-up forms. Address validation takes a submitted address and confirms whether it matches a known, deliverable address in the database, returning the canonical form and UPRN. Homedata provides both: an autocomplete endpoint for typeahead UX and a validation endpoint for batch or backend address cleansing.

How does UPRN-anchored address validation work?

UPRN-anchored validation means every confirmed address is matched to its Unique Property Reference Number — the persistent OS identifier that links the address to Land Registry, EPC, council tax, and other government datasets. This means validated addresses can be immediately enriched with property data without a second address-matching step.

GET /api/address/find/ UPRN-anchored PAF-independent

UK Address Validation API

Validate UK addresses against 29 million UPRN-matched properties using OS AddressBase Premium data. A compliant alternative to Royal Mail PAF-dependent services, with the added benefit of instant property data enrichment via the same UPRN.

Get free API key → Read the docs

Free tier: 100 calls/month · No credit card required

⚖️

October 2025 PAF ruling context

The High Court ruled in October 2025 that certain address API providers had distributed Royal Mail PAF data without a valid licence. Homedata's address data is sourced from OS AddressBase Premium — not Royal Mail PAF — and is unaffected by this ruling. If you are migrating from getAddress or a PAF-dependent provider, Homedata is a compliant drop-in alternative.

What's in the API

✓ Address autocomplete (typeahead) — returns candidate addresses as user types
✓ Address validation — confirms and canonicalises a submitted address
✓ UPRN returned with every result — enables instant property enrichment
✓ Royal Mail postal address format returned
✓ Latitude / longitude centroid
✓ Residential / commercial / mixed-use classification
✓ 29 million addresses — England, Wales, and Scotland

GET /api/address/find/?query=14+thornton+road+bristol
Authorization: Api-Key YOUR_KEY

{
  "results": [
    {
      "uprn": "10023456789",
      "address": "14 Thornton Road",
      "town": "Bristol",
      "postcode": "BS7 8EJ",
      "latitude": 51.4762,
      "longitude": -2.5989,
      "classification": "residential",
      "formatted": "14 Thornton Road, Bristol, BS7 8EJ"
    }
  ]
}

Pricing

Address lookup costs 2 API calls per request. The free tier includes 50 address lookups per month. Paid plans start at £49/month for 1,000 lookups. See full pricing.

Frequently asked questions

What happened with the getAddress PAF court ruling?

In October 2025 the High Court ruled getAddress had infringed Royal Mail's PAF IP. Homedata uses OS AddressBase Premium data and is unaffected — a compliant alternative for developers migrating away from PAF-dependent providers.

What is the difference between address validation and autocomplete?

Autocomplete returns candidates as the user types (UX). Validation confirms and canonicalises a submitted address for backend/batch processing. Homedata provides both endpoints.

How does UPRN-anchored validation work?

Every validated address is matched to its UPRN, enabling instant enrichment with EPC, flood risk, sold prices, and more via the same API — no second address-matching step required.