Skip to main content

AddressBase Premium

An address from the Ordnance Survey AddressBase Premium dataset.

Please contact us to have this enabled on your account.

All AddressBase Premium addresses have a UPRN and a rooftop geolocation available; however, they may not have a UDPRN.

A property record from Ordnance Survey's AddressBase Premium, Ordnance Survey's most detailed address dataset for Great Britain. Each record is a Basic Land and Property Unit (BLPU) keyed by its UPRN. Alongside the Royal Mail delivery point it carries the local authority address (pao_*, sao_*, usrn), classification (classification_code), lifecycle (logical_status, blpu_state), coordinates, Welsh alternatives (welsh_*), the street record (street_*) and cross references to OS MasterMap (toid), the Valuation Office Agency (council_tax_ref, ndr_ref) and ONS (ons_ward_code, ons_parish_code). Ordnance Survey publishes around 40 million records and refreshes them every six weeks.

How it differs from the neighbouring datasets:

  • AddressBase Core (ab) is a weekly, flat cut of the current approved records: one row per UPRN with coordinates, a two-character classification and the key identifiers. It carries no history, no provisional records, no Welsh alternatives, no local authority address breakdown and no street, VOA or ONS cross references.
  • Royal Mail PAF (paf) lists delivery points, keyed by UDPRN. The vast majority of PAF addresses are matched to a UPRN, but there will always be a small number (~1%) with no corresponding record on AddressBase Premium. PAF holds around 30 million GB delivery points against AddressBase Premium's 40 million UPRNs; the difference is non-postal objects (substations, car parks, sites under construction), provisional and historic records. Every GB PAF delivery point appears here as the dpa_* record.
  • OS NGD Address carries the same content restructured into feature types with daily currency. AddressBase Premium is not being retired. The Ordnance Survey end of life notice for autumn 2027 covers AddressBase and AddressBase Plus only.

Example Record​

FieldExampleType

Every field is documented below.

Essential Elements​

Standard address elements returned alongside every AddressBase Premium record.

dataset string
Dataset

Indicates the provenance of an address

Example abp
Enum
  • "abp"
id string
Id
Example abp_49020496
line_1 string
Line 1

First address line. Often contains premise and thoroughfare information. For a commercial premise the first line is the full name of the registered organisation. Never empty.

line_2 string
Line 2

Second address line. Often contains thoroughfare and locality information. May be empty.

line_3 string
Line 3

Third address line. Takes the address elements left after line_1 and line_2 are filled; where the address needs more than three lines the remaining elements are joined into line_3, comma separated. May be empty.

premise string
Premise

A pre-computed string which sensibly combines building_number, building_name and sub_building_name. Those three fields hold raw dataset values and can be difficult to parse if you are unaware of how they work together, so we also provide this single, simple premise string. Ideal if you want to pull premise information and thoroughfare information separately instead of using our address lines data.

building_number string
Building Number

Number identifying the premise on a thoroughfare or dependant thoroughfare. May be empty.

Example 1
building_name string
Building Name

Name of a residential or commercial premise. May be empty.

Examples:

  • The Manor
  • 1-2
  • A
  • 12A
  • K
  • Victoria House
sub_building_name string
Sub Building Name

Identifies a unit where a premise is split into flats, apartments or business units. Cannot be present without either building_name or building_number. E.g. Flat 1, A, 10B. May be empty.

organisation_name string
Organisation Name

Name of the business or organisation at this address. May be empty.

thoroughfare string
Thoroughfare

Also known as the street or road name. May be empty.

Example South Road
dependant_locality string
Dependant Locality

A locality that qualifies the thoroughfare. Used where the same thoroughfare name occurs more than once in a post town and no dependant thoroughfare distinguishes them. May be empty.

post_town string
Post Town

The town or city used to route mail to the address. For UK addresses this is the Royal Mail post town, which is a routing instruction rather than the nearest town geographically. Present on every address.

Example Aberystwyth
postcode string
Postcode

Correctly formatted postcode. Capitalised and spaced. Empty ("") where the address has no postcode.

Example SY23 1JT
postcode_type string
Postcode Type

Royal Mail postcode user type. UK addresses only.

  • S small user. The postcode identifies a group of delivery points. There are on average 19 delivery points per postcode, and never more than 100
  • L large user. The postcode is assigned to a single address, either because of the volume of mail it receives or because a PO Box or Selectapost service is set up

Empty ("") where not applicable.

Example S
Enum
  • "S"
  • "L"
  • ""
county string
County

Whatever county data is available for the address. Normally the postal county. If that is not present it falls back to the administrative county, then to the traditional county. May be empty where none of the three is present.

uprn string
Uprn

UPRN stands for Unique Property Reference Number and is maintained by the Ordnance Survey (OS). Local governments in the UK have allocated a unique number for each land or property.

Up to 12 digits in length.

Multiple Residence premises currently share the same UPRN as the parent premise.

May not be available for a small number of Great Britain addresses due to longer update cycles for Ordnance Survey's AddressBase datasets. Returns empty string "" in these instances, as it does for addresses outside the UK.

Although UPRN takes an integer format, we encode and transmit this data as strings. As a 12 digit number, the UPRN can exceed the maximum safe integer Number.MAX_SAFE_INTEGER in most browsers causing this datapoint to be corrupted.

Take special care when storing UPRN. As a 12 digit identifier, you will need 64 bits to encode every possible UPRN value. This means applications like Excel will corrupt cells containing UPRN values.

Example 49020496
udprn integer | string
Udprn

UDPRN stands for 'Unique Delivery Point Reference Number'. Royal Mail assigns a unique UDPRN code for each premise on PAF. Simple, unique reference number for each Delivery Point. Unlikely to be reused when an address expires.

Up to 8-digit numeric code. A new UDPRN is automatically assigned to each new Delivery Point added to PAF.

Returns 0 on a UK dataset that carries no UDPRN for the address, and an empty string "" on a non-UK address. Use id for an identifier present on every address.

Example 24255522
longitude string
Longitude
Example -4.0883772
latitude string
Latitude
Example 52.4121999

Native AddressBase Premium Record​

The native object contains the complete property-level record from Ordnance Survey AddressBase Premium — the consolidated BLPU, DPA, LPI, classification, and street records for the address.

uprn string
Unique Property Reference Number

Unique Property Reference Number - a persistent identifier for a Basic Land and Property Unit (BLPU). Up to 12 digits. Primary key for the BLPU spine. Carried as a string to preserve precision (12-digit values can exceed Number.MAX_SAFE_INTEGER).

Example 49020496
parent_uprn string
Parent UPRN

UPRN of the parent record where a parent-child relationship exists (flats sharing a building entrance, sub-units of a parent property).

Example 49020495
logical_status integer
Logical Status Code

Logical lifecycle status of the BLPU. 1 Approved, 6 Provisional, 8 Historical. BLPU records do not take value 3 (alternative).

Example 1
blpu_state string
BLPU State Code

Physical state of the BLPU. 1 Under construction, 2 In use, 3 Unoccupied / vacant / derelict, 4 No longer existing, 6 Planning permission granted.

Example 2
blpu_state_date string
BLPU State Date

Date the BLPU achieved its current state.

Format date-timeExample 2011-10-06T00:00:00.000Z
country string
Country Code

Country containing the BLPU, determined by intersection with OS Boundary-Line. E England, W Wales, S Scotland, N Northern Ireland, L Channel Islands, M Isle of Man, J not assigned to a country.

Example W
latitude number
Latitude (ETRS89)

Latitude coordinate in the ETRS89 coordinate reference system.

Format doubleExample 52.4121999
longitude number
Longitude (ETRS89)

Longitude coordinate in the ETRS89 coordinate reference system.

Format doubleExample -4.0883772
x_coordinate number
Eastings (OSGB36 British National Grid)

X location in metres on the OSGB36 British National Grid (precision 8, scale 2).

Format doubleExample 258053.87
y_coordinate number
Northings (OSGB36 British National Grid)

Y location in metres on the OSGB36 British National Grid (precision 9, scale 2).

Format doubleExample 281405.95
rpc integer
Representative Point Code

Representative Point Code - reliability of the BLPU's coordinate, as assessed by the local authority custodian. 1 Central internal, 2 General internal, 3 Transitional, 4 Street location, 5 Postcode unit, 9 Low accuracy.

Example 2
local_custodian_code integer
Local Custodian Code

4-digit identifier of the Local Authority responsible for maintaining the record.

Example 6820
addressbase_postal string
AddressBase Postal Code

Whether the address can receive mail per AddressBase rules. D linked to PAF, N not a postal address, C postal with a PAF-linked parent, L postal based on Local Authority information.

Example D
postcode_locator string
Postcode Locator

Royal Mail PAF postcode, locally assigned by the custodian, or spatially derived where no PAF match exists. Up to 8 characters.

Example SY23 1JT
multi_occ_count integer
Multi-occupancy Count

Count of child UPRNs for this record where parent-child relationships exist.

Example 4
blpu_start_date string
BLPU Start Date

Date the address record was inserted into the database.

Format date-timeExample 2007-10-24T00:00:00.000Z
blpu_end_date string
BLPU End Date

Date the address record was closed in the database.

Format date-time
blpu_last_update_date string
BLPU Last Update Date

Date of the most recent attribute change on the BLPU record.

Format date-timeExample 2025-10-13T00:00:00.000Z
blpu_entry_date string
BLPU Entry Date

Date the record was inserted into the Local Authority database.

Format date-timeExample 2006-11-24T00:00:00.000Z
udprn string
Unique Delivery Point Reference Number

Royal Mail's Unique Delivery Point Reference Number - primary key for the Delivery Point Address (DPA) record. Up to 8 digits. NULL for non-postal UPRNs.

Example 24255522
organisation_name string
Organisation Name

Royal Mail-recognised organisation name from DPA, falling back to the AddressBase Organisation record's organisation when DPA is absent. Title-cased.

department_name string
Department Name

Subdivision of an organisation that receives mail at a distinct delivery point. Requires organisation_name to be present. Title-cased.

sub_building_name string
Sub-building Name

Property subdivision identifier (e.g. flat number). Requires building_name or building_number. Title-cased. Falls back to the LPI's sao_text when there is no delivery point.

building_name string
Building Name

Descriptive name applied to a single building or small group of buildings. Title-cased. Falls back to the LPI's SAO number/range plus pao_text when there is no delivery point.

building_number integer
Building Number

Numeric identifier for a single building or small group of buildings. Complex number formats (e.g. "12A") go in building_name or sub_building_name. Falls back to the LPI's pao_start_number when there is no delivery point and that number is a bare integer - a suffixed or ranged PAO number is folded onto thoroughfare instead.

Example 1
dependent_thoroughfare string
Dependent Thoroughfare

Named thoroughfare within another named thoroughfare. Requires thoroughfare to be present. Title-cased.

Example Castle Terrace
thoroughfare string
Thoroughfare

Road, track or named access route with Royal Mail delivery points. Title-cased. Falls back to the LPI street's street_description (with a suffixed or ranged PAO number prefixed) when there is no delivery point.

Example South Road
double_dependent_locality string
Double Dependent Locality

Estate or area name used to distinguish similar thoroughfares within a dependent locality. Requires dependent_locality. Title-cased.

dependent_locality string
Dependent Locality

Subdivision of a post town to differentiate same-name thoroughfares. Title-cased. Falls back to the LPI street's street_locality when there is no delivery point.

post_town string
Post Town

Town or city of the Royal Mail sorting office serving this record. Capitalised. Falls back to the LPI street's street_town when there is no delivery point; NULL when neither is present.

Example Aberystwyth
postcode string
Postcode

Royal Mail postcode from DPA, falling back to BLPU's postcode_locator when no Royal Mail delivery point exists. Uppercased, with single space between outward and inward portions.

Example SY23 1JT
postcode_type string
Postcode Type Code

Royal Mail postal-user category. S Small user (e.g. a residential property), L Large user (e.g. a large commercial company).

Example S
delivery_point_suffix string
Delivery Point Suffix

Two-character code uniquely identifying an individual delivery point within a postcode (Royal Mail DPS).

Example 1A
po_box_number string
PO Box Number

Post Office Box number.

welsh_dependent_thoroughfare string
Welsh Dependent Thoroughfare

Welsh translation of dependent_thoroughfare. Requires welsh_thoroughfare.

Example HEOL Y CASTELL
welsh_thoroughfare string
Welsh Thoroughfare

Welsh translation of thoroughfare.

Example TAN Y CAE
welsh_double_dependent_locality string
Welsh Double Dependent Locality

Welsh translation of double_dependent_locality. Requires welsh_dependent_locality.

welsh_dependent_locality string
Welsh Dependent Locality

Welsh translation of dependent_locality.

welsh_post_town string
Welsh Post Town

Welsh translation of post_town.

Example ABERYSTWYTH
dpa_process_date string
DPA Process Date

Date the PAF record was processed into the database.

Format date-timeExample 2016-01-18T00:00:00.000Z
dpa_start_date string
DPA Start Date

Date the address record was matched to the Delivery Point Address.

Format date-timeExample 2012-04-23T00:00:00.000Z
dpa_end_date string
DPA End Date

Date the PAF record no longer existed in the database.

Format date-time
dpa_last_update_date string
DPA Last Update Date

Date any attribute on the DPA record was last changed.

Format date-timeExample 2016-02-10T00:00:00.000Z
dpa_entry_date string
DPA Entry Date

Date the PAF record was first loaded by GeoPlace.

Format date-timeExample 2012-03-19T00:00:00.000Z
classification_code string
Classification Code

Current AddressBase classification code (e.g. RD residential, CR commercial retail). Top-level categories: R Residential, C Commercial, L Land, M Military, O Other, P Parent shell, U Unclassified, X Dual use, Z Object of interest. NULL when no current classification row exists for the UPRN.

Example RD04
class_scheme string
Classification Scheme

Name of the classification scheme applied to this record.

Example AddressBase Premium Classification Scheme
scheme_version number
Classification Scheme Version

Version number of the classification scheme in use (e.g. 1.0).

Example 1
classification_start_date string
Classification Start Date

Date the classification record was first loaded into the database.

Format date-timeExample 2007-10-24T00:00:00.000Z
classification_end_date string
Classification End Date

Date the classification record ceased to exist.

Format date-time
classification_last_update_date string
Classification Last Update Date

Date of the most recent attribute change on the classification record.

Format date-timeExample 2018-09-23T00:00:00.000Z
classification_entry_date string
Classification Entry Date

Date the associated address record was inserted into the Local Authority database.

Format date-timeExample 2006-11-24T00:00:00.000Z
organisation_start_date string
Organisation Start Date

Date the organisation record was initially loaded into the database.

Format date-time
organisation_end_date string
Organisation End Date

Date the organisation record ceased to exist.

Format date-time
organisation_last_update_date string
Organisation Last Update Date

Date of the most recent attribute change on the organisation record.

Format date-time
organisation_entry_date string
Organisation Entry Date

Date the UPRN was entered into the Local Authority database.

Format date-time
lpi_key string
LPI Key

Unique identifier and primary key for the LPI record.

Example 6820L000054880
lpi_language string
LPI Language Code

Language used for this LPI record. ENG English, CYM Welsh, GAE Gaelic (Scottish), BIL Bilingual.

Example CYM
lpi_logical_status integer
LPI Logical Status Code

Logical status of the LPI record. 1 Approved, 3 Alternative, 6 Provisional, 8 Historical.

Example 1
lpi_start_date string
LPI Start Date

Date the LPI was first loaded into the database.

Format date-timeExample 2007-10-24T00:00:00.000Z
lpi_end_date string
LPI End Date

Date the LPI record ceased to exist.

Format date-time
lpi_last_update_date string
LPI Last Update Date

Date of the most recent attribute change on the LPI record.

Format date-timeExample 2025-09-26T00:00:00.000Z
lpi_entry_date string
LPI Entry Date

Date the LPI record was inserted into the Local Authority database.

Format date-timeExample 2007-09-04T00:00:00.000Z
sao_start_number integer
SAO Start Number

Number of the Secondary Addressable Object, or range start. Requires pao_start_number or pao_text to be present.

sao_start_suffix string
SAO Start Suffix

Suffix appended to sao_start_number. Requires sao_start_number.

sao_end_number integer
SAO End Number

End number of the SAO range. Requires sao_start_number.

sao_end_suffix string
SAO End Suffix

Suffix appended to sao_end_number. Requires sao_end_number.

sao_text string
SAO Text

Building name or description for the Secondary Addressable Object (e.g. "FLAT 1", "UNIT B"). Requires pao_start_number or pao_text.

pao_start_number integer
PAO Start Number

Number of the Primary Addressable Object, or range start. Mandatory if pao_text is absent.

Example 1
pao_start_suffix string
PAO Start Suffix

Suffix appended to pao_start_number. Requires pao_start_number.

pao_end_number integer
PAO End Number

End number of the PAO range. Requires pao_start_number.

pao_end_suffix string
PAO End Suffix

Suffix appended to pao_end_number. Requires pao_end_number.

pao_text string
PAO Text

Building name or description for the Primary Addressable Object. Mandatory if pao_start_number is absent.

Example HEOL Y CASTELL
usrn string
Unique Street Reference Number

Unique Street Reference Number linking this LPI to its Street record. Up to 8 digits.

Example 47114724
usrn_match_indicator string
USRN Match Indicator Code

Confidence of the LPI to Street linkage. 1 Matched manually to the nearest accessible Street, 2 Matched spatially to the nearest USRN.

Example 1
area_name string
Area Name

Third-level geographic area name such as island or property group.

level string
Level

Vertical position of the property (e.g. "GROUND FLOOR").

official_flag string
Official Flag Code

Whether the LPI corresponds to an entry in the official Street Name and Numbering register. Y Official address, N Unofficial address.

Example Y
street_record_type integer
Street Record Type Code

Description of the street record type. 1 Official designated Street Name, 2 Street Description, 3 Numbered Street, 4 Unofficial Street Description, 9 Description used for LLPG Access.

Example 1
swa_org_ref_naming integer
SWA Org Ref (Naming)

Code identifying the Street Naming and Numbering Authority or Local Highway Authority (DfT-allocated).

Example 6820
street_state string
Street State Code

Current state of the street. 1 Under construction, 2 Open, 4 Permanently closed.

Example 2
street_state_date string
Street State Date

Date when the street achieved its current state.

Format date-timeExample 1990-01-01T00:00:00.000Z
street_surface string
Street Surface Code

Surface finish of the street. 1 Metalled, 2 Unmetalled, 3 Mixed.

Example 1
street_classification string
Street Classification Code

Primary classification of the street record. 4 Pedestrian way or footpath, 6 Cycletrack or cycleway, 8 All vehicles, 9 Restricted byway, 10 Bridleway.

street_start_date string
Street Start Date

Date this street record or version was inserted into the database.

Format date-timeExample 2007-10-24T00:00:00.000Z
street_last_update_date string
Street Last Update Date

Date when any attribute of the street record was last changed.

Format date-timeExample 2022-01-14T00:00:00.000Z
street_record_entry_date string
Street Record Entry Date

Date the street record was entered into the Local Authority database.

Format date-timeExample 1998-07-14T00:00:00.000Z
street_start_x number
Street Start Eastings

X coordinate (BNG) for the street start point.

Format doubleExample 257968
street_start_y number
Street Start Northings

Y coordinate (BNG) for the street start point.

Format doubleExample 281400
street_start_lat number
Street Start Latitude

Latitude (ETRS89) for the street start point.

Format doubleExample 52.4121241
street_start_long number
Street Start Longitude

Longitude (ETRS89) for the street start point.

Format doubleExample -4.0896363
street_end_x number
Street End Eastings

X coordinate (BNG) for the street end point.

Format doubleExample 258266
street_end_y number
Street End Northings

Y coordinate (BNG) for the street end point.

Format doubleExample 281393
street_end_lat number
Street End Latitude

Latitude (ETRS89) for the street end point.

Format doubleExample 52.4121386
street_end_long number
Street End Longitude

Longitude (ETRS89) for the street end point.

Format doubleExample -4.0852551
street_tolerance integer
Street Tolerance

Accuracy of street-coordinate data capture, in metres.

Example 10
street_description string
Street Description

Street name, description or street number.

Example SOUTH ROAD
street_locality string
Street Locality

Geographical area within a town.

street_town string
Street Town

Name of the town. Required for Street Record Types 1 and 2; optional for types 3, 4 and 9.

Example ABERYSTWYTH
adminstrative_area string
Administrative Area

Local Highway Authority name (administrative area / county / unitary authority). Field name spelling preserved verbatim from OS (ADMINSTRATIVE_AREA).

Example CEREDIGION
sd_language string
Street Descriptor Language Code

Language of the street descriptor. ENG English, CYM Welsh, GAE Gaelic (Scottish), BIL Bilingual.

Example ENG
sd_start_date string
Street Descriptor Start Date

Date the street descriptor record was first created in the database.

Format date-timeExample 2007-10-24T00:00:00.000Z
sd_end_date string
Street Descriptor End Date

Date the street descriptor record ceased to exist.

Format date-time
sd_last_update_date string
Street Descriptor Last Update Date

Date of the most recent attribute change on the street descriptor record.

Format date-timeExample 2016-02-06T00:00:00.000Z
sd_entry_date string
Street Descriptor Entry Date

Date the street descriptor record was entered into the Local Authority database.

Format date-timeExample 1998-07-14T00:00:00.000Z
toid string
TOID (Topography)

OS MasterMap Topography Layer TOID (cross-reference source 7666MT) linked to the UPRN.

Example osgb1000020592167
toid_address string
TOID (Address Layer)

OS MasterMap Address Layer 2 TOID (cross-reference source 7666MA) linked to the UPRN.

Example osgb1000002175099422
toid_highways string
TOID (Highways)

OS MasterMap Highways TOID (cross-reference source 7666MI) linked to the UPRN.

Example osgb5000005181786114
council_tax_ref string
Council Tax Reference

Centrally created Valuation Office Agency council tax reference (cross-reference source 7666VC) linked to the UPRN.

ndr_ref string
Non-Domestic Rates Reference

Centrally created Valuation Office Agency non-domestic rates reference (cross-reference source 7666VN) linked to the UPRN.

ons_ward_code string
ONS Ward Code

Office for National Statistics ward code (cross-reference source 7666OW) linked to the UPRN.

Example W05001302
ons_parish_code string
ONS Parish Code

Office for National Statistics parish code (cross-reference source 7666OP) linked to the UPRN.

Example W04000359