Address API After the PAF Ruling: A Compliant Alternative
The October 2025 High Court ruling on Royal Mail PAF licensing disrupted several popular UK address lookup APIs. If you are migrating away from a PAF-dependent provider, Homedata's UPRN-anchored address API — built on OS AddressBase Premium — is a compliant, feature-rich alternative with a free tier.
October 2025 ruling summary
The High Court ruled that certain address API providers had infringed Royal Mail's intellectual property by distributing PAF-derived data without a valid sublicence. Affected services were required to cease distribution or obtain direct Royal Mail licences. Homedata uses OS AddressBase Premium data and is not subject to this ruling.
PAF vs OS AddressBase — what developers need to know
| Attribute | Royal Mail PAF | OS AddressBase (Homedata) |
|---|---|---|
| Coverage | ~30M postal addresses | 39M+ UPRNs (all addressable locations) |
| UPRN included | No | Yes — every result |
| Non-deliverable properties | Not covered | Included |
| Scottish addresses | Yes | Yes |
| Property data enrichment | Not available | EPC, sold prices, flood risk via same API |
| PAF ruling exposure | High (licensing dependent) | None — OS data, not PAF |
| Free tier | Via licensed providers only | 100 calls/month, no card |
Migration from getAddress or PAF providers
The Homedata address API is a drop-in replacement for getAddress and similar providers. The endpoint accepts a partial address or postcode and returns a list of matching addresses with canonical format, UPRN, and coordinates.
Unlike PAF-based providers, every result includes a UPRN — enabling immediate enrichment with EPC, flood risk, sold prices, and council tax data without a second address-matching step.
Migration guide in docs →GET /api/address/find/?query=SW1A+2AA
Authorization: Api-Key YOUR_KEY
{
"results": [
{
"uprn": "100021887955",
"address": "10 Downing Street",
"town": "London",
"postcode": "SW1A 2AA",
"latitude": 51.5034,
"longitude": -0.1276,
"classification": "commercial",
"formatted": "10 Downing Street, London, SW1A 2AA"
}
],
"total": 1
}
Frequently asked questions
What did the October 2025 PAF ruling mean?
The High Court ruled that distributing PAF data without a Royal Mail licence infringes their IP. Providers using unlicensed PAF were required to cease or obtain direct licences.
What is the difference between PAF and OS AddressBase?
PAF covers ~30M postal addresses. OS AddressBase covers 39M+ UPRNs including non-deliverable properties, with UPRN on every record for property data enrichment.
Is Homedata affected by the PAF ruling?
No — Homedata uses OS AddressBase Premium, not Royal Mail PAF. It is a compliant alternative unaffected by the ruling.