About UPRN.org.uk 🏠

What is UPRN.org.uk? 🤔

UPRN.org.uk is an independent, open-source project that enhances Ordnance Survey's open UPRN dataset. While OS provides the basic UPRN locations, they don't include house numbers, names, or street details. Our community fills in these crucial missing pieces, creating a more complete and useful address dataset.

Download Current Address Data (CSV) Download as OpenStreetMap (OSM)

Open Source & Community Driven 👥

This is a 100% open-source project - both the code and the data we collect are freely available to everyone. You can:

• Contribute to the codebase on GitHub
• Use and share the data we collect
• Help improve address accuracy in your local area
• Join our community of contributors

Our Approach 🎯

We start with Ordnance Survey's open UPRN coordinate data and enhance it through community contributions. Our project:

• Uses the official UPRN locations from OS Open Data
• Crowdsources the missing house numbers, names, and street details
• Combines these to create a complete, open address dataset
• Makes all our enhanced data freely available under an open license

Open Data & Mapping 🛰️

We exclusively use open data sources in our project:

• EU Sentinel-2 satellite imagery (up to zoom level 13) as our base mapping layer
• Community-contributed address information
• All data collected is available under open data principles

Data Licensing 📜

Our data comes from two main sources:

• OS Open UPRN - providing the base UPRN locations
• OS Open Zoomstack - providing the street network data

Our combined dataset contains:

• Contains OS data © Crown copyright and database right 2025
• Community-contributed address information licensed under the Open Government Licence v3.0

While UPRNs themselves are managed by GeoPlace and licensed through Ordnance Survey, the community-contributed address information and street associations on UPRN.org.uk are made available under the Open Government Licence.

API Documentation 🔌

UPRN.org.uk provides two main API endpoints for accessing UPRN and address data:

1. Individual UPRN Lookup

Example: GET /uprns/100023336956.json

Returns details for a specific UPRN:

{
  "uprn": "100023336956",
  "latitude": 51.12345,
  "longitude": -0.12345,
  "has_address": true,
  "address": {
    "house_identifier": "42",
    "street": {
      "id": 123,
      "name": "High Street"
    }
  },
  "history": [
    {
      "house_identifier": "42",
      "street": {
        "id": 123,
        "name": "High Street"
      },
      "visible": true,
      "changed_by": "john_smith",
      "comment": "Initial address creation",
      "created_at": "2024-01-01T12:00:00Z",
      "edit_location": {
        "latitude": 51.12345,
        "longitude": -0.12345
      }
    }
  ]
}

2. Bounding Box Search

Example: GET /uprns.json?min_lat=51.1&max_lat=51.2&min_lng=-0.1&max_lng=0.0

Returns up to 400 UPRNs within the specified bounding box:

[
  {
    "uprn": "100023336956",
    "latitude": 51.12345,
    "longitude": -0.12345,
    "has_address": true,
    "address": {
      "house_identifier": "42",
      "street": {
        "id": 123,
        "name": "High Street"
      }
    }
  },
  // ... more results ...
]

Note: The bounding box search is limited to 400 results to maintain performance.

Response Fields

• uprn: The Unique Property Reference Number
• latitude, longitude: Location in WGS84 coordinates
• has_address: Whether this UPRN has an address recorded
• house_identifier: Either a house number or name
• street: Contains street details including name and ID
• history: List of previous versions with change details (single UPRN endpoint only)

Data Formats

The API supports the following formats:

• JSON: Default format for API responses
• CSV: Available for bulk downloads
• OSM: OpenStreetMap XML format for bulk downloads

Get Involved 🌟

As an open-source project, we welcome all forms of contribution:

• Add and verify addresses in your area
• Contribute to our codebase on GitHub
• Help improve our documentation
• Spread the word about open address data

Contact & Community 💬

Join our Discord community to:

• Get help and support
• Share ideas and feedback
• Connect with other contributors
• Stay updated on project developments

Join our Discord Server