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 thedpa_*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
{"uprn": "49020496","parent_uprn": "49020495","logical_status": 1,"blpu_state": "2","blpu_state_date": "2011-10-06T00:00:00.000Z","country": "W","latitude": 52.4121999,"longitude": -4.0883772,"x_coordinate": 258053.87,"y_coordinate": 281405.95,"rpc": 2,"local_custodian_code": 6820,"addressbase_postal": "D","postcode_locator": "SY23 1JT","multi_occ_count": 4,"blpu_start_date": "2007-10-24T00:00:00.000Z","blpu_end_date": null,"blpu_last_update_date": "2025-10-13T00:00:00.000Z","blpu_entry_date": "2006-11-24T00:00:00.000Z","udprn": "24255522","organisation_name": null,"legal_name": null,"department_name": null,"sub_building_name": null,"building_name": null,"building_number": 1,"dependent_thoroughfare": "Castle Terrace","thoroughfare": "South Road","double_dependent_locality": null,"dependent_locality": null,"post_town": "Aberystwyth","postcode": "SY23 1JT","postcode_type": "S","delivery_point_suffix": "1A","po_box_number": null,"welsh_dependent_thoroughfare": "HEOL Y CASTELL","welsh_thoroughfare": "TAN Y CAE","welsh_double_dependent_locality": null,"welsh_dependent_locality": null,"welsh_post_town": "ABERYSTWYTH","dpa_process_date": "2016-01-18T00:00:00.000Z","dpa_start_date": "2012-04-23T00:00:00.000Z","dpa_end_date": null,"dpa_last_update_date": "2016-02-10T00:00:00.000Z","dpa_entry_date": "2012-03-19T00:00:00.000Z","classification_code": "RD04","class_scheme": "AddressBase Premium Classification Scheme","scheme_version": 1,"classification_start_date": "2007-10-24T00:00:00.000Z","classification_end_date": null,"classification_last_update_date": "2018-09-23T00:00:00.000Z","classification_entry_date": "2006-11-24T00:00:00.000Z","organisation_start_date": null,"organisation_end_date": null,"organisation_last_update_date": null,"organisation_entry_date": null,"lpi_key": "6820L000054880","lpi_language": "CYM","lpi_logical_status": 1,"lpi_start_date": "2007-10-24T00:00:00.000Z","lpi_end_date": null,"lpi_last_update_date": "2025-09-26T00:00:00.000Z","lpi_entry_date": "2007-09-04T00:00:00.000Z","sao_start_number": null,"sao_start_suffix": null,"sao_end_number": null,"sao_end_suffix": null,"sao_text": null,"pao_start_number": 1,"pao_start_suffix": null,"pao_end_number": null,"pao_end_suffix": null,"pao_text": "HEOL Y CASTELL","usrn": "47114724","usrn_match_indicator": "1","area_name": null,"level": null,"official_flag": "Y","street_record_type": 1,"swa_org_ref_naming": 6820,"street_state": "2","street_state_date": "1990-01-01T00:00:00.000Z","street_surface": "1","street_classification": null,"street_start_date": "2007-10-24T00:00:00.000Z","street_last_update_date": "2022-01-14T00:00:00.000Z","street_record_entry_date": "1998-07-14T00:00:00.000Z","street_start_x": 257968,"street_start_y": 281400,"street_start_lat": 52.4121241,"street_start_long": -4.0896363,"street_end_x": 258266,"street_end_y": 281393,"street_end_lat": 52.4121386,"street_end_long": -4.0852551,"street_tolerance": 10,"street_description": "SOUTH ROAD","street_locality": null,"street_town": "ABERYSTWYTH","adminstrative_area": "CEREDIGION","sd_language": "ENG","sd_start_date": "2007-10-24T00:00:00.000Z","sd_end_date": null,"sd_last_update_date": "2016-02-06T00:00:00.000Z","sd_entry_date": "1998-07-14T00:00:00.000Z","toid": "osgb1000020592167","toid_address": "osgb1000002175099422","toid_highways": "osgb5000005181786114","council_tax_ref": null,"ndr_ref": null,"ons_ward_code": "W05001302","ons_parish_code": "W04000359","id": "abp_49020496","dataset": "abp","country_iso": "GBR","suggestion_line": "1 Castle Terrace South Road, Aberystwyth, SY23"}Every field is documented below.
Essential Elements
Standard address elements returned alongside every AddressBase Premium record.
datasetstring- Dataset
Indicates the provenance of an address
Enum- "abp"
idstring- Id
line_1string- 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_2string- Line 2
Second address line. Often contains thoroughfare and locality information. May be empty.
line_3string- Line 3
Third address line. Takes the address elements left after
line_1andline_2are filled; where the address needs more than three lines the remaining elements are joined intoline_3, comma separated. May be empty. premisestring- 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_numberstring- Building Number
Number identifying the premise on a thoroughfare or dependant thoroughfare. May be empty.
building_namestring- Building Name
Name of a residential or commercial premise. May be empty.
Examples:
- The Manor
- 1-2
- A
- 12A
- K
- Victoria House
sub_building_namestring- 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_namestring- Organisation Name
Name of the business or organisation at this address. May be empty.
thoroughfarestring- Thoroughfare
Also known as the street or road name. May be empty.
dependant_localitystring- 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_townstring- 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.
postcodestring- Postcode
Correctly formatted postcode. Capitalised and spaced. Empty (
"") where the address has no postcode. postcode_typestring- Postcode Type
Royal Mail postcode user type. UK addresses only.
Ssmall user. The postcode identifies a group of delivery points. There are on average 19 delivery points per postcode, and never more than 100Llarge 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.Enum- "S"
- "L"
- ""
countystring- 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.
uprnstring- 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_INTEGERin 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.
udprninteger | 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
0on a UK dataset that carries no UDPRN for the address, and an empty string""on a non-UK address. Useidfor an identifier present on every address. longitudestring- Longitude
latitudestring- 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.
uprnstring- 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).
parent_uprnstring- Parent UPRN
UPRN of the parent record where a parent-child relationship exists (flats sharing a building entrance, sub-units of a parent property).
logical_statusinteger- Logical Status Code
Logical lifecycle status of the BLPU.
1Approved,6Provisional,8Historical. BLPU records do not take value3(alternative). blpu_statestring- BLPU State Code
Physical state of the BLPU.
1Under construction,2In use,3Unoccupied / vacant / derelict,4No longer existing,6Planning permission granted. blpu_state_datestring- BLPU State Date
Date the BLPU achieved its current state.
countrystring- Country Code
Country containing the BLPU, determined by intersection with OS Boundary-Line.
EEngland,WWales,SScotland,NNorthern Ireland,LChannel Islands,MIsle of Man,Jnot assigned to a country. latitudenumber- Latitude (ETRS89)
Latitude coordinate in the ETRS89 coordinate reference system.
longitudenumber- Longitude (ETRS89)
Longitude coordinate in the ETRS89 coordinate reference system.
x_coordinatenumber- Eastings (OSGB36 British National Grid)
X location in metres on the OSGB36 British National Grid (precision 8, scale 2).
y_coordinatenumber- Northings (OSGB36 British National Grid)
Y location in metres on the OSGB36 British National Grid (precision 9, scale 2).
rpcinteger- Representative Point Code
Representative Point Code - reliability of the BLPU's coordinate, as assessed by the local authority custodian.
1Central internal,2General internal,3Transitional,4Street location,5Postcode unit,9Low accuracy. local_custodian_codeinteger- Local Custodian Code
4-digit identifier of the Local Authority responsible for maintaining the record.
addressbase_postalstring- AddressBase Postal Code
Whether the address can receive mail per AddressBase rules.
Dlinked to PAF,Nnot a postal address,Cpostal with a PAF-linked parent,Lpostal based on Local Authority information. postcode_locatorstring- Postcode Locator
Royal Mail PAF postcode, locally assigned by the custodian, or spatially derived where no PAF match exists. Up to 8 characters.
multi_occ_countinteger- Multi-occupancy Count
Count of child UPRNs for this record where parent-child relationships exist.
blpu_start_datestring- BLPU Start Date
Date the address record was inserted into the database.
blpu_end_datestring- BLPU End Date
Date the address record was closed in the database.
blpu_last_update_datestring- BLPU Last Update Date
Date of the most recent attribute change on the BLPU record.
blpu_entry_datestring- BLPU Entry Date
Date the record was inserted into the Local Authority database.
udprnstring- 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.
organisation_namestring- Organisation Name
Royal Mail-recognised organisation name from DPA, falling back to the AddressBase Organisation record's
organisationwhen DPA is absent. Title-cased. legal_namestring- Legal Name
Registered legal name from the AddressBase Organisation record.
department_namestring- Department Name
Subdivision of an organisation that receives mail at a distinct delivery point. Requires
organisation_nameto be present. Title-cased. sub_building_namestring- Sub-building Name
Property subdivision identifier (e.g. flat number). Requires
building_nameorbuilding_number. Title-cased. Falls back to the LPI'ssao_textwhen there is no delivery point. building_namestring- 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_textwhen there is no delivery point. building_numberinteger- Building Number
Numeric identifier for a single building or small group of buildings. Complex number formats (e.g. "12A") go in
building_nameorsub_building_name. Falls back to the LPI'spao_start_numberwhen there is no delivery point and that number is a bare integer - a suffixed or ranged PAO number is folded ontothoroughfareinstead. dependent_thoroughfarestring- Dependent Thoroughfare
Named thoroughfare within another named thoroughfare. Requires
thoroughfareto be present. Title-cased. thoroughfarestring- 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. double_dependent_localitystring- Double Dependent Locality
Estate or area name used to distinguish similar thoroughfares within a dependent locality. Requires
dependent_locality. Title-cased. dependent_localitystring- Dependent Locality
Subdivision of a post town to differentiate same-name thoroughfares. Title-cased. Falls back to the LPI street's
street_localitywhen there is no delivery point. post_townstring- Post Town
Town or city of the Royal Mail sorting office serving this record. Capitalised. Falls back to the LPI street's
street_townwhen there is no delivery point; NULL when neither is present. postcodestring- Postcode
Royal Mail postcode from DPA, falling back to BLPU's
postcode_locatorwhen no Royal Mail delivery point exists. Uppercased, with single space between outward and inward portions. postcode_typestring- Postcode Type Code
Royal Mail postal-user category.
SSmall user (e.g. a residential property),LLarge user (e.g. a large commercial company). delivery_point_suffixstring- Delivery Point Suffix
Two-character code uniquely identifying an individual delivery point within a postcode (Royal Mail DPS).
po_box_numberstring- PO Box Number
Post Office Box number.
welsh_dependent_thoroughfarestring- Welsh Dependent Thoroughfare
Welsh translation of
dependent_thoroughfare. Requireswelsh_thoroughfare. welsh_thoroughfarestring- Welsh Thoroughfare
Welsh translation of
thoroughfare. welsh_double_dependent_localitystring- Welsh Double Dependent Locality
Welsh translation of
double_dependent_locality. Requireswelsh_dependent_locality. welsh_dependent_localitystring- Welsh Dependent Locality
Welsh translation of
dependent_locality. welsh_post_townstring- Welsh Post Town
Welsh translation of
post_town. dpa_process_datestring- DPA Process Date
Date the PAF record was processed into the database.
dpa_start_datestring- DPA Start Date
Date the address record was matched to the Delivery Point Address.
dpa_end_datestring- DPA End Date
Date the PAF record no longer existed in the database.
dpa_last_update_datestring- DPA Last Update Date
Date any attribute on the DPA record was last changed.
dpa_entry_datestring- DPA Entry Date
Date the PAF record was first loaded by GeoPlace.
classification_codestring- Classification Code
Current AddressBase classification code (e.g.
RDresidential,CRcommercial retail). Top-level categories:RResidential,CCommercial,LLand,MMilitary,OOther,PParent shell,UUnclassified,XDual use,ZObject of interest. NULL when no current classification row exists for the UPRN. class_schemestring- Classification Scheme
Name of the classification scheme applied to this record.
scheme_versionnumber- Classification Scheme Version
Version number of the classification scheme in use (e.g.
1.0). classification_start_datestring- Classification Start Date
Date the classification record was first loaded into the database.
classification_end_datestring- Classification End Date
Date the classification record ceased to exist.
classification_last_update_datestring- Classification Last Update Date
Date of the most recent attribute change on the classification record.
classification_entry_datestring- Classification Entry Date
Date the associated address record was inserted into the Local Authority database.
organisation_start_datestring- Organisation Start Date
Date the organisation record was initially loaded into the database.
organisation_end_datestring- Organisation End Date
Date the organisation record ceased to exist.
organisation_last_update_datestring- Organisation Last Update Date
Date of the most recent attribute change on the organisation record.
organisation_entry_datestring- Organisation Entry Date
Date the UPRN was entered into the Local Authority database.
lpi_keystring- LPI Key
Unique identifier and primary key for the LPI record.
lpi_languagestring- LPI Language Code
Language used for this LPI record.
ENGEnglish,CYMWelsh,GAEGaelic (Scottish),BILBilingual. lpi_logical_statusinteger- LPI Logical Status Code
Logical status of the LPI record.
1Approved,3Alternative,6Provisional,8Historical. lpi_start_datestring- LPI Start Date
Date the LPI was first loaded into the database.
lpi_end_datestring- LPI End Date
Date the LPI record ceased to exist.
lpi_last_update_datestring- LPI Last Update Date
Date of the most recent attribute change on the LPI record.
lpi_entry_datestring- LPI Entry Date
Date the LPI record was inserted into the Local Authority database.
sao_start_numberinteger- SAO Start Number
Number of the Secondary Addressable Object, or range start. Requires
pao_start_numberorpao_textto be present. sao_start_suffixstring- SAO Start Suffix
Suffix appended to
sao_start_number. Requiressao_start_number. sao_end_numberinteger- SAO End Number
End number of the SAO range. Requires
sao_start_number. sao_end_suffixstring- SAO End Suffix
Suffix appended to
sao_end_number. Requiressao_end_number. sao_textstring- SAO Text
Building name or description for the Secondary Addressable Object (e.g. "FLAT 1", "UNIT B"). Requires
pao_start_numberorpao_text. pao_start_numberinteger- PAO Start Number
Number of the Primary Addressable Object, or range start. Mandatory if
pao_textis absent. pao_start_suffixstring- PAO Start Suffix
Suffix appended to
pao_start_number. Requirespao_start_number. pao_end_numberinteger- PAO End Number
End number of the PAO range. Requires
pao_start_number. pao_end_suffixstring- PAO End Suffix
Suffix appended to
pao_end_number. Requirespao_end_number. pao_textstring- PAO Text
Building name or description for the Primary Addressable Object. Mandatory if
pao_start_numberis absent. usrnstring- Unique Street Reference Number
Unique Street Reference Number linking this LPI to its Street record. Up to 8 digits.
usrn_match_indicatorstring- USRN Match Indicator Code
Confidence of the LPI to Street linkage.
1Matched manually to the nearest accessible Street,2Matched spatially to the nearest USRN. area_namestring- Area Name
Third-level geographic area name such as island or property group.
levelstring- Level
Vertical position of the property (e.g. "GROUND FLOOR").
official_flagstring- Official Flag Code
Whether the LPI corresponds to an entry in the official Street Name and Numbering register.
YOfficial address,NUnofficial address. street_record_typeinteger- Street Record Type Code
Description of the street record type.
1Official designated Street Name,2Street Description,3Numbered Street,4Unofficial Street Description,9Description used for LLPG Access. swa_org_ref_naminginteger- SWA Org Ref (Naming)
Code identifying the Street Naming and Numbering Authority or Local Highway Authority (DfT-allocated).
street_statestring- Street State Code
Current state of the street.
1Under construction,2Open,4Permanently closed. street_state_datestring- Street State Date
Date when the street achieved its current state.
street_surfacestring- Street Surface Code
Surface finish of the street.
1Metalled,2Unmetalled,3Mixed. street_classificationstring- Street Classification Code
Primary classification of the street record.
4Pedestrian way or footpath,6Cycletrack or cycleway,8All vehicles,9Restricted byway,10Bridleway. street_start_datestring- Street Start Date
Date this street record or version was inserted into the database.
street_last_update_datestring- Street Last Update Date
Date when any attribute of the street record was last changed.
street_record_entry_datestring- Street Record Entry Date
Date the street record was entered into the Local Authority database.
street_start_xnumber- Street Start Eastings
X coordinate (BNG) for the street start point.
street_start_ynumber- Street Start Northings
Y coordinate (BNG) for the street start point.
street_start_latnumber- Street Start Latitude
Latitude (ETRS89) for the street start point.
street_start_longnumber- Street Start Longitude
Longitude (ETRS89) for the street start point.
street_end_xnumber- Street End Eastings
X coordinate (BNG) for the street end point.
street_end_ynumber- Street End Northings
Y coordinate (BNG) for the street end point.
street_end_latnumber- Street End Latitude
Latitude (ETRS89) for the street end point.
street_end_longnumber- Street End Longitude
Longitude (ETRS89) for the street end point.
street_toleranceinteger- Street Tolerance
Accuracy of street-coordinate data capture, in metres.
street_descriptionstring- Street Description
Street name, description or street number.
street_localitystring- Street Locality
Geographical area within a town.
street_townstring- Street Town
Name of the town. Required for Street Record Types
1and2; optional for types3,4and9. adminstrative_areastring- Administrative Area
Local Highway Authority name (administrative area / county / unitary authority). Field name spelling preserved verbatim from OS (
ADMINSTRATIVE_AREA). sd_languagestring- Street Descriptor Language Code
Language of the street descriptor.
ENGEnglish,CYMWelsh,GAEGaelic (Scottish),BILBilingual. sd_start_datestring- Street Descriptor Start Date
Date the street descriptor record was first created in the database.
sd_end_datestring- Street Descriptor End Date
Date the street descriptor record ceased to exist.
sd_last_update_datestring- Street Descriptor Last Update Date
Date of the most recent attribute change on the street descriptor record.
sd_entry_datestring- Street Descriptor Entry Date
Date the street descriptor record was entered into the Local Authority database.
toidstring- TOID (Topography)
OS MasterMap Topography Layer TOID (cross-reference source
7666MT) linked to the UPRN. toid_addressstring- TOID (Address Layer)
OS MasterMap Address Layer 2 TOID (cross-reference source
7666MA) linked to the UPRN. toid_highwaysstring- TOID (Highways)
OS MasterMap Highways TOID (cross-reference source
7666MI) linked to the UPRN. council_tax_refstring- Council Tax Reference
Centrally created Valuation Office Agency council tax reference (cross-reference source
7666VC) linked to the UPRN. ndr_refstring- Non-Domestic Rates Reference
Centrally created Valuation Office Agency non-domestic rates reference (cross-reference source
7666VN) linked to the UPRN. ons_ward_codestring- ONS Ward Code
Office for National Statistics ward code (cross-reference source
7666OW) linked to the UPRN. ons_parish_codestring- ONS Parish Code
Office for National Statistics parish code (cross-reference source
7666OP) linked to the UPRN.