Open Nav

UDPRN: Unique Delivery Point Reference Number

Understanding the unique ID number assigned to every premise in the UK

Updated 23 Mar 2020

The UDPRN code was introduced by Royal Mail in 2004 and inserted into the Postcode Address File. It is a unique code used to identify a delivery point (i.e. premise) in PAF.

Ideal Postcodes allows queries for premises by UDPRN via the /udprn endpoint

Some key features are:

  • Simple, unique reference number for each Delivery Point
  • Far less likely to be reused than the existing PAF Keys
  • 8-character numeric code
  • A new UDPRN is automatically assigned to each new Delivery Point added to PAF

Why Is It Useful?

Since UDPRN values are a consistent identifier for a given delivery point in PAF, if stored, it can be used to retrieve the most recent information for a given premise in case any of its addressing information has changed.

It can also be used to test for a decommissioned or demolished premise.

Extracting UDPRN from Ideal Postcodes

We provide direct access to UDPRN in our API to pull out individual premises.

Requests are as simple as:

https://api.ideal-postcodes.co.uk/v1/udprn/012345678

A single address object is returned in the result attribute:

{
    "result":{
        "postcode":"ID1 1QD",
        "postcode_inward":"IQD",
        "postcode_outward":"ID1",
        "post_town":"LONDON",
        "dependant_locality":"",
        "double_dependant_locality":"",
        "thoroughfare":"Barons Court Road",
        "dependant_thoroughfare":"",
        "building_number":"2",
        "building_name":"",
        "sub_building_name":"",
        "po_box":"",
        "department_name":"",
        "organisation_name":"",
        "udprn":25962203,
        "umprn" : "",
        "postcode_type":"S",
        "su_organisation_indicator":"",
        "delivery_point_suffix":"1G",
        "line_1":"2 Barons Court Road",
        "line_2":"",
        "line_3":"",
        "premise":"2",
        "county": "Greater London",
        "administrative_county": "",
        "postal_county": "",
        "traditional_county": "Greater London",
        "district": "Hammersmith and Fulham",
        "ward": "North End",
        "country": "England",
        "longitude":-0.208644362766368,
        "latitude":51.4899488390558,
        "eastings":524466,
        "northings":178299
    },
    "code":2000,
    "message":"Success"
}

More information can be found in our documentation or try it yourself below with our JavaScript client.

const { Client } = require("@ideal-postcodes/core-node"); const client = new Client({ api_key: "iddqd" }); const udprn = 23747771; const address = await client.lookupUdprn({ udprn });