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.

Essential Elements​

Standard address elements returned alongside every AddressBase Premium record.

Dataset​

datasetstring

Indicates the provenance of an address

Values
  • "abp"

Id​

id

Line 1​

line_1

Line 2​

line_2

Line 3​

line_3

Premise​

premise

Building Number​

building_number

Building Name​

building_name

Sub Building Name​

sub_building_name

Organisation Name​

organisation_name

Thoroughfare​

thoroughfare

Dependant Locality​

dependant_locality

Post Town​

post_town

Postcode​

postcode

Postcode Type​

postcode_type

County​

county

Uprn​

uprn

Udprn​

udprn

Longitude​

longitude

Latitude​

latitude

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.

Unique Property Reference Number​

uprnstring

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).

Parent UPRN​

parent_uprnstring

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

Logical Status Code​

logical_statusinteger

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

BLPU State Code​

blpu_statestring

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

BLPU State Date​

blpu_state_datestring

Date the BLPU achieved its current state.

Format
date-time

Country Code​

countrystring

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.

Latitude (ETRS89)​

latitudenumber

Latitude coordinate in the ETRS89 coordinate reference system.

Format
double

Longitude (ETRS89)​

longitudenumber

Longitude coordinate in the ETRS89 coordinate reference system.

Format
double

Eastings (OSGB36 British National Grid)​

x_coordinatenumber

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

Format
double

Northings (OSGB36 British National Grid)​

y_coordinatenumber

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

Format
double

Representative Point Code​

rpcinteger

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.

Local Custodian Code​

local_custodian_codeinteger

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

AddressBase Postal Code​

addressbase_postalstring

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.

Postcode Locator​

postcode_locatorstring

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

Multi-occupancy Count​

multi_occ_countinteger

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

BLPU Start Date​

blpu_start_datestring

Date the address record was inserted into the database.

Format
date-time

BLPU End Date​

blpu_end_datestring

Date the address record was closed in the database.

Format
date-time

BLPU Last Update Date​

blpu_last_update_datestring

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

Format
date-time

BLPU Entry Date​

blpu_entry_datestring

Date the record was inserted into the Local Authority database.

Format
date-time

Unique Delivery Point Reference Number​

udprnstring

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.

Organisation Name​

organisation_namestring

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

legal_namestring

Registered legal name from the AddressBase Organisation record.

Department Name​

department_namestring

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

Sub-building Name​

sub_building_namestring

Property subdivision identifier (e.g. flat number). Requires building_name or building_number.

Building Name​

building_namestring

Descriptive name applied to a single building or small group of buildings.

Building Number​

building_numberinteger

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.

Dependent Thoroughfare​

dependent_thoroughfarestring

Named thoroughfare within another named thoroughfare. Requires thoroughfare to be present.

Thoroughfare​

thoroughfarestring

Road, track or named access route with Royal Mail delivery points.

Double Dependent Locality​

double_dependent_localitystring

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

Dependent Locality​

dependent_localitystring

Subdivision of a post town to differentiate same-name thoroughfares.

Post Town​

post_townstring

Town or city of the Royal Mail sorting office serving this record. Uppercased. NULL for non-postal UPRNs (no Royal Mail delivery point).

Postcode​

postcodestring

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.

Postcode Type Code​

postcode_typestring

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

Delivery Point Suffix​

delivery_point_suffixstring

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

PO Box Number​

po_box_numberstring

Post Office Box number.

Welsh Dependent Thoroughfare​

welsh_dependent_thoroughfarestring

Welsh translation of dependent_thoroughfare. Requires welsh_thoroughfare.

Welsh Thoroughfare​

welsh_thoroughfarestring

Welsh translation of thoroughfare.

Welsh Double Dependent Locality​

welsh_double_dependent_localitystring

Welsh translation of double_dependent_locality. Requires welsh_dependent_locality.

Welsh Dependent Locality​

welsh_dependent_localitystring

Welsh translation of dependent_locality.

Welsh Post Town​

welsh_post_townstring

Welsh translation of post_town.

DPA Process Date​

dpa_process_datestring

Date the PAF record was processed into the database.

Format
date-time

DPA Start Date​

dpa_start_datestring

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

Format
date-time

DPA End Date​

dpa_end_datestring

Date the PAF record no longer existed in the database.

Format
date-time

DPA Last Update Date​

dpa_last_update_datestring

Date any attribute on the DPA record was last changed.

Format
date-time

DPA Entry Date​

dpa_entry_datestring

Date the PAF record was first loaded by GeoPlace.

Format
date-time

Classification Code​

classification_codestring

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.

Classification Scheme​

class_schemestring

Name of the classification scheme applied to this record.

Classification Scheme Version​

scheme_versionnumber

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

Classification Start Date​

classification_start_datestring

Date the classification record was first loaded into the database.

Format
date-time

Classification End Date​

classification_end_datestring

Date the classification record ceased to exist.

Format
date-time

Classification Last Update Date​

classification_last_update_datestring

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

Format
date-time

Classification Entry Date​

classification_entry_datestring

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

Format
date-time

Organisation Start Date​

organisation_start_datestring

Date the organisation record was initially loaded into the database.

Format
date-time

Organisation End Date​

organisation_end_datestring

Date the organisation record ceased to exist.

Format
date-time

Organisation Last Update Date​

organisation_last_update_datestring

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

Format
date-time

Organisation Entry Date​

organisation_entry_datestring

Date the UPRN was entered into the Local Authority database.

Format
date-time

LPI Key​

lpi_keystring

Unique identifier and primary key for the LPI record.

LPI Language Code​

lpi_languagestring

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

LPI Logical Status Code​

lpi_logical_statusinteger

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

LPI Start Date​

lpi_start_datestring

Date the LPI was first loaded into the database.

Format
date-time

LPI End Date​

lpi_end_datestring

Date the LPI record ceased to exist.

Format
date-time

LPI Last Update Date​

lpi_last_update_datestring

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

Format
date-time

LPI Entry Date​

lpi_entry_datestring

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

Format
date-time

SAO Start Number​

sao_start_numberinteger

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

SAO Start Suffix​

sao_start_suffixstring

Suffix appended to sao_start_number. Requires sao_start_number.

SAO End Number​

sao_end_numberinteger

End number of the SAO range. Requires sao_start_number.

SAO End Suffix​

sao_end_suffixstring

Suffix appended to sao_end_number. Requires sao_end_number.

SAO Text​

sao_textstring

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​

pao_start_numberinteger

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

PAO Start Suffix​

pao_start_suffixstring

Suffix appended to pao_start_number. Requires pao_start_number.

PAO End Number​

pao_end_numberinteger

End number of the PAO range. Requires pao_start_number.

PAO End Suffix​

pao_end_suffixstring

Suffix appended to pao_end_number. Requires pao_end_number.

PAO Text​

pao_textstring

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

Unique Street Reference Number​

usrnstring

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

USRN Match Indicator Code​

usrn_match_indicatorstring

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

Area Name​

area_namestring

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

Level​

levelstring

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

Official Flag Code​

official_flagstring

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

Street Record Type Code​

street_record_typeinteger

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.

SWA Org Ref (Naming)​

swa_org_ref_naminginteger

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

Street State Code​

street_statestring

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

Street State Date​

street_state_datestring

Date when the street achieved its current state.

Format
date-time

Street Surface Code​

street_surfacestring

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

Street Classification Code​

street_classificationstring

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​

street_start_datestring

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

Format
date-time

Street Last Update Date​

street_last_update_datestring

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

Format
date-time

Street Record Entry Date​

street_record_entry_datestring

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

Format
date-time

Street Start Eastings​

street_start_xnumber

X coordinate (BNG) for the street start point.

Format
double

Street Start Northings​

street_start_ynumber

Y coordinate (BNG) for the street start point.

Format
double

Street Start Latitude​

street_start_latnumber

Latitude (ETRS89) for the street start point.

Format
double

Street Start Longitude​

street_start_longnumber

Longitude (ETRS89) for the street start point.

Format
double

Street End Eastings​

street_end_xnumber

X coordinate (BNG) for the street end point.

Format
double

Street End Northings​

street_end_ynumber

Y coordinate (BNG) for the street end point.

Format
double

Street End Latitude​

street_end_latnumber

Latitude (ETRS89) for the street end point.

Format
double

Street End Longitude​

street_end_longnumber

Longitude (ETRS89) for the street end point.

Format
double

Street Tolerance​

street_tolerancenumber

Accuracy of street-coordinate data capture, in metres.

Street Description​

street_descriptionstring

Street name, description or street number.

Street Locality​

street_localitystring

Geographical area within a town.

Street Town​

street_townstring

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

Administrative Area​

adminstrative_areastring

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

Street Descriptor Language Code​

sd_languagestring

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

Street Descriptor Start Date​

sd_start_datestring

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

Format
date-time

Street Descriptor End Date​

sd_end_datestring

Date the street descriptor record ceased to exist.

Format
date-time

Street Descriptor Last Update Date​

sd_last_update_datestring

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

Format
date-time

Street Descriptor Entry Date​

sd_entry_datestring

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

Format
date-time

TOID (Topography)​

toidstring

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

TOID (Address Layer)​

toid_addressstring

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

TOID (Highways)​

toid_highwaysstring

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

Council Tax Reference​

council_tax_refstring

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

Non-Domestic Rates Reference​

ndr_refstring

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

ONS Ward Code​

ons_ward_codestring

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

ONS Parish Code​

ons_parish_codestring

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