Datasets
This page details the output results returned by the dataset
query parameter for DPA
or LPI
.
The default is DPA
. You can query both datasets by separating the values with a comma (DPA,LPI
).
Please read this page in conjunction with Technical specification (see in particular the Response > results (array of object) > DPA (object) / LPI (object) dropdown of each query type.)
DPA output
A Delivery Point Address (DPA) is one that Ordnance Survey has matched against a Royal Mail PAF address, including addresses within Northern Ireland, Channel Islands and Isle of Man. Not every property record has an associated DPA record. See AddressBase Premium technical guide for more information.
Key | Description | Format | Size | Multiplicity |
---|---|---|---|---|
| The Unique Property Reference Number. For addresses in Northern Ireland, an empty string is returned. | integer | 12 | 1 |
| Royal Mail's Unique Delivery Point Reference Number. | integer | 8 | 1 |
| String containing the concatenated address. | char | 472 | 1 |
| Post Office Box (PO Box®) number. | char | 6 | 0..1 |
| The organisation name is the business name given to a delivery point within a building or small group of buildings. This field could also include entries for churches, public houses and libraries. | char | 60 | 0..1 |
| In a few organisations, department name is indicated because mail is received by subdivisions of the main organisation at distinct delivery points. | char | 60 | 0..1 |
| The sub-building name and/or number are identifiers for subdivision of properties. | char | 30 | 0..1 |
| The building name is a description applied to a single building or a small group of buildings. | char | 50 | 0..1 |
| The building number, or postal number, is a number given to a single building or a small group of buildings. | integer | 4 | 0..1 |
| In certain places, for example, town centres, there are named thoroughfares within other named thoroughfares. | char | 80 | 0..1 |
| A road, track or named access route on which there are Royal Mail delivery points. | char | 80 | 0..1 |
| To distinguish between similar or same thoroughfares within a dependent locality. | char | 35 | 0..1 |
| Dependent locality areas may define an area within a post town. | char | 35 | 0..1 |
| The town or city in which the Royal Mail sorting office is located. | char | 30 | 1 |
| A postcode is an abbreviated form of address made up of combinations of between five and seven alphanumeric characters. | char | 8 | 1 |
| Representative Point Code: this describes the accuracy of the coordinate that has been allocated to the BLPU. See RPC code for more information. | char | 1 | 1 |
| Easting coordinates in metres, defining the location in the British National Grid spatial reference system. | float | 6 (2) | 1 |
| Northing coordinates in metres, defining the location in the British National Grid spatial reference system. | float | 7 (2) | 1 |
| Longitude coordinate, defined based on the requested projection. | float | 9 | 0..1 |
| Latitude coordinate, defined based on the requested projection. | float | 9 | 0..1 |
| The status of the feature (i.e. | char | 11 | 1 |
| The match score for the query against the returned address from | float | 1 (1) | 0..1 |
| The description of the match. Exact: | char | 8 | 0..1 |
| A code identifying the language in use for the record. | char | 2 | 1 |
| Unique identifier of the Local Land and Property Gazetteer (LLPG) Custodian responsible for the maintenance of this record. Download the Local Custodian code list (ZIP). | integer | 4 | 1 |
| Description of the Local Land and Property Gazetteer (LLPG) Custodian responsible for the maintenance of this record. | char | as per code definition document | 1 |
| A description that describes the classification of the record, for example, | char | 1, 2, 4, 6 | 1 |
| A description that describes the classification of the record, for example, | char | as per code definition document | 1 |
| A code that describes the type of postal delivery that the object is subject to. | char | 1 | 1 |
| A description that describes the type of postal delivery that the object is subject to. | char | 100 | 1 |
| A code for the logical status of the BLPU. See Logical status code for more information. | integer | 1 | 1 |
| A code for the physical nature of the property or land object. These are used to represent the physical state or the feature. See BLPU state code for more information. | integer | 1 | 1 |
| A description for the physical nature of the property or land object. These are used to represent the physical state or the feature. | char | as per code definition document | 0..1 |
| Unique key for the application cross reference record. | char | 20 | 1 |
| UPRN of the parent record. | integer | 12 | 0..1 |
| Date this record was last updated. | date | date | 1 |
| Date of the data entry. | date | date | 1 |
| Registered legal name of organisation. | char | 60 | 0..1 |
| Date at which the BLPU achieved its current state in the real-world. | date | date | 0..1 |
| A code to uniquely identify an individual delivery point within a postcode. | char | 2 | 1 |
| Office for National Statistics (ONS) Parish code. | char | 9 | 1 |
| Office for National Statistics (ONS) Ward code. | char | 9 | 1 |
LPI output
A Land Property Identifier (LPI) address is a structured text entry that identifies a Basic Land and Property Unit (BLPU) within AddressBase® Premium and does not need to receive deliveries from the Royal Mail to exist. This means that some non-postal objects (for example, a church) can be included.
The AddressBase Premium data structure provides the facility to describe a BLPU by more than one LPI. In England and Scotland there is one Approved LPI, whereas in Wales there are two Approved LPIs (English and Welsh). See AddressBase Premium technical guide for more information.
Key | Description | Format | Size | Multiplicity |
---|---|---|---|---|
| Foreign key used to reference the delivery point address to the corresponding BLPU. | integer | 12 | 1 |
| Concatenated Address field. | char | 504 | 1 |
| A code identifying the language in use for the record. | char | 2 | 1 |
| Foreign key linking the Street record to the LPI record. | integer | 8 | 1 |
| Unique key for the LPI. | char | 14 | 1 |
| Memorandum of the vertical position of the address. | char | 30 | 0..1 |
| Name of current occupier on the fascia of the BLPU. | char | 100 | 1 |
| The number of the secondary addressable object (SAO) or the start of the number range. | integer | 4 | 0..1 |
| The suffix to the | char | 2 | 0..1 |
| The end of the number range for the SAO. | integer | 4 | 0..1 |
| The suffix to the | char | 2 | 0..1 |
| Contains the building name or description for the SAO. | char | 90 | 0..1 |
| The number of the primary addressable object (PAO) or the start of the number range. | integer | 4 | 0..1 |
| The suffix to the | char | 2 | 0..1 |
| The end of the number range for the PAO. | integer | 4 | 0..1 |
| The suffix to the | char | 2 | 0..1 |
| Contains the building name or description for the PAO. | char | 90 | 0..1 |
| Name, description or street number. | char | 100 | 0..1 |
| A LOCALITY defines an area or geographical identifier within a town, village or hamlet. | char | 35 | 0..1 |
| Town name. | char | 30 | 0..1 |
| Local Highway Authority name. | char | 30 | 0..1 |
| Third level of geographic area name, for example, to record island names or property groups such as crofts. | char | 35 | 0..1 |
| Postcode of the coordinate for the BLPU based purely on a spatial match against Code-Point® with polygons. This field must be used in conjunction with the RPC field to determine the accuracy of its position. | char | 8 | 1 |
| Representative Point Code: this describes the accuracy of the coordinate that has been allocated to the BLPU. See RPC code for more information. | char | 1 | 1 |
| Easting coordinates in metres, defining the location in the British National Grid spatial reference system. | float | 6 (2) | 1 |
| Northing coordinates in metres, defining the location in the British National Grid spatial reference system. | float | 7 (2) | 1 |
| Longitude coordinate, defined based on the requested projection. | float | 9 | 0..1 |
| Latitude coordinate, defined based on the request projection. | float | 9 | 0..1 |
| The status of the feature (i.e. | char | 11 | 1 |
| The match score for the query against the returned address from | float | 1 (1) | 0..1 |
| The description of the match. Exact: | char | 8 | 0..1 |
| Unique identifier of the Local Land and Property Gazetteer (LLPG) Custodian responsible for the maintenance of this record. Download the Local Custodian code list (ZIP). | integer | 4 | 1 |
| Description of the Local Land and Property Gazetteer (LLPG) Custodian responsible for the maintenance of this record. | char | as per code definition document | 1 |
| A code that describes the classification of the record, for example, | char | 1, 2, 4, 6 | 1 |
| A description that describes the classification of the record, for example, | char | as per code definition document | 1 |
| A code that describes the type of postal delivery that the object is subject to. | char | 1 | 1 |
| A description that describes the type of postal delivery that the object is subject to. | char | 100 | 1 |
| A code identifying the current state of the Street. | integer | 1 | 0..1 |
| A description identifying the current state of the Street. | char | 100 | 0..1 |
| A code for the primary street classification. | char | 2 | 0..1 |
| A description for the primary street classification. | char | as per code definition document | 1 |
| A code for the logical status of the BLPU. See Logical status codefor more information. | integer | 1 | 1 |
| A code for the physical nature of the property or land object. These are used to represent the physical state or the feature. See BLPU state code for more information. | integer | 1 | 1 |
| A description for the physical nature of the property or land object. These are used to represent the physical state or the feature. | char | 1 | 0..1 |
| Unique key for the application cross reference record. | char | 20 | 1 |
| UPRN of the parent record. | integer | 12 | 0..1 |
| Date this record was last updated. | date | date | 1 |
| Date of the data entry. | date | date | 1 |
| Registered legal name of organisation. | char | 60 | 0..1 |
| Date at which the BLPU achieved its current state in the real-world. | date | date | 0..1 |
| A code for the logical status of this record. See LPI logical status code for more information. | integer | 1 | 1 |
| A description of the Logical Status reflects where the LPI has reached in its life cycle. Logical status is important in identification of the addresses’ requirements, for example, whether it is an alternative address or an historic address. | char | as per code definition document | 0..1 |
| Office for National Statistics (ONS) Parish code. | char | 9 | 1 |
| Office for National Statistics (ONS) Ward code. | char | 9 | 1 |
Last updated