Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The OS NGD Address Theme provides a complete and definitive view of UK address data. It's designed to underpin a range of analytical use cases and provide the most detailed view of an address and its lifecycle.
The OS NGD Address Theme contains all of the address data found in the AddressBase Premium product:
Local Authority and Royal Mail postal addresses
Lifecycle data
Addresses for features that are not conventionally addressable (such as warehouses, car parks, etc.)
Multi-lingual addresses
Alternative addresses
However, the OS NGD Address Theme builds on the AddressBase Premium data by providing data with up to daily currency that is simple to use, understand and interrogate. This makes the data more accessible to non-address experts as it is easy to plug and play it into databases or a GIS.
The theme is interoperable with other OS NGD themes through cross-reference information and the Unique Property Reference Number (UPRN) as the key identifier, allowing you to easily combine multiple datasets to answer analytical questions.
Address data is collated from Local Land and Property Gazetteers (LLPG), which are maintained by Local Authorities in England and Wales, and also from Local Authorities in Scotland, who maintain the Corporate Address Gazetteer (CAG). These data sources are supplemented by the Royal Mail Postcode Address File (PAF), references to Valuation Office Agency (VOA) data in England and Wales, and additional addresses and coordinates from Ordnance Survey.
Please note that the OS NGD Address Theme is only available via OS Select+Build and is not available via OS NGD API – Features or OS NGD API – Tiles.
The OS NGD Address Theme is made up of the OS NGD GB Address and OS NGD Islands Address Collections, and each collection is comprised of five feature types: Built Address, Historic Address, Non-Addressable Object, Pre-Build Address, and Street Address.
The five feature types for each collection are supported by four additional related components which provide supplementary information against each UPRN. The four additional related components are:
Postal Address: These contain delivery point data from the Royal Mail PAF.
Other Classification: These provide additional VOA classification information.
Related Entity: These contain cross-reference information to other OS NGD themes or third-party data sets.
For more information, please see the Related Components page.
Four unique identifiers are provided with each feature within the OS NGD Address Theme:
Unique Property Reference Number (UPRN): The primary identifier and unique key for this theme. A UPRN is a unique and persistent numeric identifier for every addressable location in Great Britain. Each address record has a UPRN, assigned by Local Authorities in England, Wales and Scotland or Ordnance Survey depending on the type of address. Throughout its lifecycle, information on the address of a property can change. This may be due to a change of name, change of use, or the eventual demolition of the property. Independent of any changes being made the UPRN associated to an address is never changed, meaning the unique identifier remains persistent and reliable.
Unique Street Reference Number (USRN): A USRN is a unique and persistent identifier for a street which is curated by Local Authority custodians in England, Wales or Scotland.
OSID (Ordnance Survey Identifier): A primary identifier and unique key used in other OS NGD themes. OSIDs are referenced in the OS NGD Address Theme for purposes of cross-refencing to other themes.
TOID (Topographic Identifier): An additional secondary identifier which can aid further data linking. TOIDs are an optional attribute and therefore will not always be provided with every feature.
The OS NGD GB Address Collection is a complete, analytical and authoritative addressing dataset for Great Britain. It is designed to provide a detailed view of an address and its lifecycle.
The OS NGD GB Address Collection allows you to:
Keep your address data current with up to daily updates.
Utilise the richness of Local Authority data and analyse addresses by their classification, postal status and build status to create a detailed picture of a given area.
Carry out spatial analysis and aggregation using the accurate rooftop coordinates provided for each address.
Easily identify and download addresses by pre-build, built and historic lifecycle stages.
Use the Unique Property Reference Number (UPRN) to easily link different data sets right down to a single address.
Up to daily updates to data.
New simplified data model means there’s no need to be an addressing expert to use the data.
Plug and play – the data is simple and quick to implement as you don't need to pre-process it before you use it.
Rich attribution ensures the data is straightforward to navigate and query.
Persistent unique identifiers with lifecycle information.
The ability to select addresses from a specific lifecycle state (for example, Built Address and Pre-Build Address).
Full UK address coverage available via accessing the OS NGD GB Address and Islands Address Collections together.
New cross-references make it easy for you to link data in this collection with data from other OS NGD collections.
Great Britain.
British National Grid (EPSG: 27700).
The earliest date on which you can request a one-off snapshot of a date in the past for data in this collection is noted at the top of the individual feature type pages.
GeoPackage or CSV (comma-separated values).
Accessed through the OS Data Hub via OS Select+Build. It can't be accessed through OS NGD API – Features or OS NGD API – Tiles.
Included in the Public Sector Geospatial Agreement (PSGA) – therefore, it's free at point of use for Public Sector organisations.
Available to OS Partners for commercial resell in your solutions.
The Street Address Feature Type provides street address information for any road, footpath, cycleway, byway, or bridleway that has been uniquely identified by the local Highway Authority, or Street Naming and Numbering authority and provides access to an address.
The earliest date on which you can request a one-off snapshot of a date in the past for data in this feature type is 02 November 2022.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0
Description of the street record type, for example, whether the Street has an official designated street name.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 33
OS Select+Build Filterable: No
Data Schema Version: 1.0
A code for the primary street classification, for example, denoting it to be 'open to all vehicles'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 26
OS Select+Build Filterable: No
Data Schema Version: 1.0
Description of the current state of the Street, indicating which point the street record is at within its lifecycle.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 18
OS Select+Build Filterable: No
Data Schema Version: 1.0
Date at which the Street achieved its current state in the world, as referenced by the 'operationalState' attribute.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the settlement that the Street is located within. A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the Administrative Unit that the Address is located within.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the Administrative Unit that the Address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0
Alphanumeric code which identifies the Street Naming and Numbering Authority or the Local Highway Authority
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 4
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the responsible Street Naming and Numbering Authority or Local Highways Authority
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Description indicating the type of surface finish on the Street, for example, 'Metalled'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 10
OS Select+Build Filterable: No
Data Schema Version: 1.0
X coordinate in metres for the position of the start point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
Y coordinate in metres for the position of the start point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
X coordinate in metres for the position of the end point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
Y coordinate in metres for the position of the end point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Latitude of the position of the start point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Longitude of the position of the start point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Latitude of the position of the end point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Longitude of the position of the end point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
Geometry Type: MultiPoint
The tolerance of the Start and End Location coordinates in metres.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date on which the record ceased to exist
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0
The Pre-Build Address Feature Type represents local authority addresses that will be able to receive mail, deliveries or services, where the property is either yet to be built but has been granted planning permission, or is under construction. Pre-build addresses can take the format of a development site, a plot number, or a definitive address for property units.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|---|---|
More information about data schema versioning in the OS NGD Address Theme is available from the 'Versioning information' page and the 'Data schema versioning' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: changetypevalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressdescriptionvalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: countryvalue
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: buildstatusvalue
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressstatusvalue
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressbasepostalvalue
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence Block in a University as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: usrnmatchindicatorvalue
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: positionalaccuracyvalue
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Historic Address Feature Type represents local authority addresses that are no longer in existence. This can occur as a result of demolition or the merging of two built properties to become one new single address, or the splitting of a single property into multiple flats for example.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|
More information about data schema versioning in the OS NGD Address Theme is available from the '' page and the '' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence Block in a University as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Non-Addressable Object Feature Type represents local authority and Ordnance Survey captured features that are currently live but are objects that would not be expected to be able to receive mail or deliveries. These objects typically represent structures or sites rather than buildings that somebody could conceivably live, work or engage in leisure activities within. For example, ponds and static water sites, public parks and telephone boxes.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|
More information about data schema versioning in the OS NGD Address Theme is available from the '' page and the '' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence Block in a University as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Historic Address Feature Type represents local authority addresses that are no longer in existence. This can occur as a result of demolition or the merging of two built properties to become one new single address, or the splitting of a single property into multiple flats for example.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|
More information about data schema versioning in the OS NGD Address Theme is available from the '' page and the '' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence Block in a University as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD Islands Address Collection is a complete, analytical and authoritative addressing dataset for Northern Ireland, the Channel Islands and the Isle of Man. It is designed to provide a detailed view of an address and its lifecycle.
The OS NGD Islands Address Collection allows you to:
Keep your address data current with up to daily updates.
Utilise the richness of additional attribution about each address and analyse addresses by their classification, postal status and build status to create a detailed picture of a given area.
Carry out spatial analysis and aggregation using the accurate rooftop coordinates provided for each address.
Easily identify and download addresses by pre-build, built and historic lifecycle stages.
Use the Unique Property Reference Number (UPRN) to easily link different data sets right down to a single address.
Up to daily updates to data.
New simplified data model means there’s no need to be an addressing expert to use the data.
Plug and play – the data is simple and quick to implement as you don't need to pre-process it before you use it.
Rich attribution ensures the data is straightforward to navigate and query.
Persistent unique identifiers with lifecycle information.
The ability to select addresses from a specific lifecycle state (for example, Built Address and Pre-Build Address).
Full UK address coverage available via accessing the OS NGD GB Address and Islands Address Collections together.
New cross-references make it easy for you to link data in this collection with data from other OS NGD collections.
Northern Ireland, the Channel Islands, and the Isle of Man.
European Terrestrial Reference System 89 (EPSG: ETRS89).
The earliest date on which you can request a one-off snapshot of a date in the past for data in this collection is noted at the top of the individual feature type pages.
GeoPackage or CSV (comma-separated values).
Included in the Public Sector Geospatial Agreement (PSGA) – therefore, it's free at point of use for Public Sector organisations.
Available to OS Partners for commercial resell in your solutions.
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the .
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the .
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the .
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the .
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the .
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the .
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Code List Name:
Accessed through the via OS Select+Build. It can't be accessed through OS NGD API – Features or OS NGD API – Tiles.
1.0
02 November 2022
Ongoing
2.0
28 March 2023
Ongoing
1.0 | 02 November 2022 | Ongoing |
2.0 | 28 March 2023 | Ongoing |
1.0 | 02 November 2022 | Ongoing |
2.0 | 28 March 2023 | Ongoing |
1.0 | 02 November 2022 | Ongoing |
2.0 | 28 March 2023 | Ongoing |
Related components can be joined to feature types using the Unique Property Reference Number (UPRN) as the foreign key. These related components provide supplementary information or context to UPRNs. For example, providing cross-reference relationships between addresses and features in other OS NGD collections, such as buildings, sites, roads and boundaries, or the Royal Mail PAF view of an address where matched to a Local Authority UPRN.
The related components do not contain geometry and therefore need to be joined to the relevant feature type table using the UPRN. When data is supplied, you will receive related component data split out by feature type. For example, customers taking Pre-Build and Built Address in GeoPackage format will receive:
Feature type: Pre-Build Address
Related component: Pre-Build Alternate Address
Related component: Pre-Build Postal Address
Related component: Pre-Build Related Entity
Related component: Pre-Build Other Classification
Please note that Related Components will always be provided if you have chosen to receive any of the OS NGD Address Theme data.
The Alternate Address Related Component provides alternative address labels where they exist for the ‘current’ address represented on a given feature type.
There are two principal scenarios by which an Alternate Address can be created; both of these scenarios will result in addresses being present in the Alternate Address Related Component.
Official alternate addresses captured by Local Authorities. This occurs where there is a a variation on the official address held by Local Authorities that is represented by the preferred UPRN in the Built Address Feature Type. For example, ‘10 High Street’ may have an alternate address label captured as ‘Rose Cottage’. These addresses are represented by an ‘Alternate’ classification in the Address Status attribute.
Built Address: UPRN 12345: 12 High Street, addressstatus: Approved Alternate Address: UPRN 12345: Rose Cottage, addresstatus: Alternate
An additional non-official address captured for lifecycle purposes. In the case of pre-build addresses, these alternate addresses commonly represent labels attached to the plot in earlier stages in the development cycle, that have subsequently been updated. Historic address alternate address labels, where held, will be early iterations of the address that became live and will be alternate addresses of the ‘current’ UPRN on the Pre-Build Feature Type. Built Address: UPRN 12345: Explorer House, Adanac Drive, SO15 0AS, addressstatus: Approved Alternate Address: UPRN 12345: Development Site, addressstatus: Historic Alternate Address: UPRN 12345: Plot 12, addressstatus: Historic
The following sub-sections provide details about the attributes included with this related component, their data types in the different output formats, and other important metadata about them.
Primary Key providing a unique row identifier assigned to enable indexing for efficient querying.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 36
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date of the feature version to which this related entity applies.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Alternative, Approved, Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressstatuscode
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateSubName provides an alternative address label to the one provided in the subName. An alternative address label may be present for a number of reasons, e.g. retention of an old address label or an alias address label has been recorded by the Local Authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateName provides an alternative address label to the one provided in the name. An alternative address label may be present for a number of reasons, e.g. retention of an old address label or an alias address label has been recorded by the Local Authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateNumber provides an alternative address number to the one provided in the number attribute.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of a populated place within a settlement that the Street is located within. Where a locality can be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a Settlement can be a City, Town, Village or Hamlet.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The language in which the address label attribution has been captured for the alternative record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: languagevalue
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: The level on which the access point to the Address is present, or the floor level or levels that the Address is located on, or fully occupies.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
The date on which any attribute of the Record was last changed.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Street Address Feature Type provides street address information for any road, footpath, cycleway, byway, or bridleway that has been uniquely identified by the local Highway Authority, or Street Naming and Numbering authority and provides access to an address.
The earliest date on which you can request a one-off snapshot of a date in the past for data in this feature type is 02 November 2022.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: changetypevalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: streetdescriptionvalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0
Description of the street record type, for example, whether the Street has an official designated street name.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressstreettypevalue
Max Length: 33
OS Select+Build Filterable: No
Data Schema Version: 1.0
A code for the primary street classification, for example, denoting it to be 'open to all vehicles'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: streetclassificationvalue
Max Length: 26
OS Select+Build Filterable: No
Data Schema Version: 1.0
Description of the current state of the Street, indicating which point the street record is at within its lifecycle.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: streetstatevalue
Max Length: 18
OS Select+Build Filterable: No
Data Schema Version: 1.0
Date at which the Street achieved its current state in the world, as referenced by the 'operationalState' attribute.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the settlement that the Street is located within. A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the Administrative Unit that the Address is located within.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: countryvalue
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the Administrative Unit that the Address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0
Alphanumeric code which identifies the Street Naming and Numbering Authority or the Local Highway Authority
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 4
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Name of the responsible Street Naming and Numbering Authority or Local Highways Authority
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0
Description indicating the type of surface finish on the Street, for example, 'Metalled'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: streetsurfacevalue
Max Length: 10
OS Select+Build Filterable: No
Data Schema Version: 1.0
X coordinate in metres for the position of the start point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
Y coordinate in metres for the position of the start point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
X coordinate in metres for the position of the end point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
Y coordinate in metres for the position of the end point of the street defined in British National Grid (EPSG::27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Latitude of the position of the start point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Longitude of the position of the start point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Latitude of the position of the end point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Value defining the Longitude of the position of the end point of the street defined in accordance with the ETRS89 (EPSG::4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
Geometry Type: MultiPoint
The tolerance of the Start and End Location coordinates in metres.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0
The date on which the record ceased to exist
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0
The Related Entity Related Component provides cross-reference information to key identifiers from other datasets, allowing for the linking of the UPRN (Unique Property Reference Number) to its associated feature types:
OS MasterMap Topographic Area TOID
OS MasterMap Highways Road Link TOID
NGD Administrative and Statistical Units Boundaries Parish or Community GSS Code
NGD Administrative and Statistical Units Ward GSS Code
Valuation Office Agency Council Tax Assessment UARN
Valuation Office Agency Non-Domestic Rate Assessment UARN
OS NGD Buildings Theme – Building Part Polygon OSID
OS NGD Structures Theme – Compound Structure OSID
OS NGD Structures Theme – Structure OSID
OS NGD Transport Theme – Road, Track, or Path Polygon OSID
OS NGD Transport Network Collection – Road Link OSID
OS NGD Land Theme – Land Cover Polygon OSID
OS NGD Water Theme – Water Polygon OSID
Channel Islands Unique Identifier (only available for the GB Address Collection)
Channel Islands Street Identifier (only available for the GB Address Collection)
Northern Ireland Street Identifier (only available for the GB Address Collection)
Isle of Man Street Identifier (only available for the GB Address Collection)
The following sub-sections provide details about the attributes included with this related component, their data types in the different output formats, and other important metadata about them.
Primary Key providing a unique row identifier assigned to enable indexing for efficient querying.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 36
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date of the feature version to which this related entity applies.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Description of the related dataset that the cross reference refers to, for example, VOA Council Tax.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifier of the related Data Entity or Feature Type instance that is the target of the reference or link.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 36
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Type of relationship which has been formed between the source and target features, for example, Within, partOf or SameAs.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the originating data provider that defined the reference or link.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which any attribute of the Record was last changed.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which this relationship was first added into the database.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 2.0
The date on which the relationship ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 2.0
The Other Classification Related Component provides additional classification data beyond that held by Local Authorities for an address record. This data type contains VOA Council Tax and Non-Domestic Rate classification information in the form of Special Category Codes (SCAT) and Primary Description codes where VOA information has been matched to a Local Authority address. Note that VOA classifications are only available for England and Wales.
The following sub-sections provide details about the attributes included with this related component, their data types in the different output formats, and other important metadata about them.
Primary Key providing a unique row identifier assigned to enable indexing for efficient querying.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 36
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date of the feature version to which this related entity applies.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 230
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the classification schema.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 60
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Version of the classification schema.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 60
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which any attribute of the Record was last changed.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Postal Address Related Component provides the Royal Mail delivery point address from PAF where it has been matched to a Local Authority address in the National Land and Property Gazetteer.
The following sub-sections provide details about the attributes included with this related component, their data types in the different output formats, and other important metadata about them.
Royal Mail’s Unique Delivery Point Reference Number (UDPRN).
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date of the feature version to which this related entity applies.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address within a building or small group of buildings. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 60
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
For some organisations, department name is indicated because mail is received by subdivisions of the main organisation at distinct delivery points.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 60
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The sub-building name and/or number are identifiers for subdivisions of properties.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The building name is a description applied to a single building or a small group of buildings, such as Highfield House. This also includes those building numbers that contain non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the building name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The building number is a number given to a single building or a small group of buildings, thus identifying it from its neighbours, for example, 44. Building numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the building name or the subbuilding name fields.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 4
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In certain places, for example, town centres, there are named thoroughfares within other named thoroughfares, for example, parades of shops on a high street where different parades have their own identity. For example, KINGS PARADE, HIGH STREET and QUEENS PARADE, HIGH STREET.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 80
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A thoroughfare is a road, track or named access route on which there are Royal Mail delivery points, for example, HIGH STREET.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 80
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
This is used to distinguish between similar thoroughfares or the same thoroughfare within a dependent locality. For example, Millbrook Industrial Estate and Cranford Estate in this situation: BRUNEL WAY, MILLBROOK INDUSTRIAL ESTATE, MILLBROOK, SOUTHAMPTON and BRUNEL WAY, CRANFORD ESTATE, MILLBROOK, SOUTHAMPTON.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Dependent locality areas define an area within a post town. These are only necessary for postal purposes and are used to aid differentiation where there are thoroughfares of the same name in the same locality. For example, HIGH STREET in SHIRLEY and SWAYTHLING in this situation: HIGH STREET, SHIRLEY, SOUTHAMPTON and HIGH STREET, SWAYTHLING, SOUTHAMPTON.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The town or city in which the Royal Mail sorting office is located which services this record. There may be more than one, possibly several, sorting offices in a town or city.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Describes the address as a small or large user as defined by Royal Mail. A large user postcode typically receives over 100 pieces of mail per day.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 10
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A two-character code uniquely identifying an individual delivery point within a postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Welsh translation of dependentThoroughfare
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 80
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Welsh translation of thoroughfare
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 80
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Welsh translation of doubleDependentLocality
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Welsh translation of dependentLocality
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Welsh translation of postTown
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 6
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the PAF record was processed into the database
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the originating data provider that defined the reference or link.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which any attribute of the Record was last changed.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Built Address Feature Type represents local authority addresses that are currently built and live and can typically receive mail, deliveries, or services. For example, homes, shops, schools and hospitals.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|---|---|
More information about data schema versioning in the OS NGD Address Theme is available from the 'Versioning information' page and the 'Data schema versioning' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: changetypevalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressdescriptionvalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: countryvalue
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: buildstatusvalue
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressstatusvalue
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressbasepostalvalue
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence block in a university as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: usrnmatchindicatorvalue
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: positionalaccuracyvalue
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Pre-Build Address Feature Type represents local authority addresses that will be able to receive mail, deliveries or services, where the property is either yet to be built but has been granted planning permission, or is under construction. Pre-build addresses can take the format of a development site, a plot number, or a definitive address for property units.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|---|---|
More information about data schema versioning in the OS NGD Address Theme is available from the 'Versioning information' page and the 'Data schema versioning' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: changetypevalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressdescriptionvalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: countryvalue
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: buildstatusvalue
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressstatusvalue
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressbasepostalvalue
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence Block in a University as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: usrnmatchindicatorvalue
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: positionalaccuracyvalue
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Built Address Feature Type represents local authority addresses that are currently built and live and can typically receive mail, deliveries, or services. For example, homes, shops, schools and hospitals.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|---|---|
More information about data schema versioning in the OS NGD Address Theme is available from the 'Versioning information' page and the 'Data schema versioning' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: changetypevalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressdescriptionvalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). This includes numbers that contain a range, decimals or non-numeric characters, for example 1-11 and 10A.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: countryvalue
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: buildstatusvalue
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressstatusvalue
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressbasepostalvalue
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence Block in a University as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: usrnmatchindicatorvalue
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: positionalaccuracyvalue
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Non-Addressable Object Feature Type represents local authority and Ordnance Survey captured features that are currently live but are objects that would not be expected to be able to receive mail or deliveries. These objects typically represent structures or sites rather than buildings that somebody could conceivably live, work or engage in leisure activities within. For example, ponds and static water sites, public parks and telephone boxes.
The earliest and latest dates on which you can request a one-off snapshot of a date in the past for the data schema versions available for this feature type are detailed in the following table:
| Data schema version | Earliest date | Latest date |
|---|---|---|
More information about data schema versioning in the OS NGD Address Theme is available from the 'Versioning information' page and the 'Data schema versioning' page.
Please note that if you select Annual Full Supply with an initial supply date of 01 Jan 2023 as the update frequency for a data package containing data schema version 2.0 of this feature type in OS Select+Build, this will result in you receiving an empty data package. This is because data schema version 2.0 for this feature type was only made available in the OS NGD from 28 March 2023. The Full Annual Supply option for data schema version 2.0 for this feature type will become available from 01 January 2024.
The following sub-sections provide details about the attributes included with this feature type, their data types in the different output formats, and other important metadata about them.
Unique Property Reference Number (UPRN) assigned by a local custodian or Ordnance Survey as a persistent identifier.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Date when the version was last updated.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature became the latest version.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date this version of the feature was superseded by an update or ceased to exist.
Data Types: DateTime (GPKG), DateTime (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The type of change that generated a new version of the feature.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: changetypevalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The OS NGD theme to which this feature belongs.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: themevalue
Max Length: 40
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
A single descriptive value intended for a quick understanding of what the feature represents.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressdescriptionvalue
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The organisation name is the business name given to an Address. For example: TOURIST INFORMATION CENTRE. This field could also include entries for churches, public houses and libraries.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or the British Forces Post Office (BFPO) number.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The SubName is the secondary description for subdivisions of properties. For example: SubName: 'CRYNANT LIBRARY', Name: 'CRYNANT COMMUNITY CENTRE'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The name is the English language primary description applied to an address, for example: 'SWANSEA UNIVERSITY BAY CAMPUS' (Welsh: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE'). This attribute will also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The number gives a unique numeric identifier for addresses on a given street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable Street that an Address is located on or close to.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within. For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the settlement that the Street is located within. Where a settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The postcode unit that the Address is situated within. A postcode is an abbreviated form of address, made up of combinations of between five and seven alphanumeric characters. These alphanumeric characters are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses. Postcodes (for example, NW6 4DP) are comprised of two components. The first component is the outward code (or ‘outcode’), which is the first two to four characters of a postcode, constituting the postcode area and the postcode district, for example, NW6. The outward code is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery. The second component of a postcode is the inward code (or ‘incode’), which is the last three characters of the postcode, constituting the postcode sector and the postcode unit, for example, 4DP. The inward code is used to sort mail at the local delivery office. This field will contain the Royal Mail Postcode Address File (PAF) postcode where the Local Authority address has been matched to PAF. Where a match has not been made, the postcode information is sourced from Local Authority assigned data. In cases where the Local Authority do not hold a valid postcode, a spatial nearest neighbour function is used to spatially derive the postcode from the closest Address with a valid postcode.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 8
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Concatenation of the following address components: organisation (Pre-Build and Built Address Feature Types only), subname and / or name and / or number, streetname, locality, townname, islandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: countryvalue
Max Length: 16
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The alternateLanguageSubName is the alternate language secondary description for subdivisions of properties. For example: alternateLanguageSubName: 'LLYFRGELL Y CREUNANT', alternateLanguageName: 'CANOLFAN CYMUNED CREUNANT'.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageName is the alternate language primary description applied to an address, for example: 'CAMPWS Y BAE PRIFYSGOL ABERTAWE' (English: 'SWANSEA UNIVERSITY BAY CAMPUS'). This attribute may also include numbers when the name contains non-numeric characters, such as 44A. Some descriptive names, when included with the rest of the address, are sufficient to identify the property uniquely and unambiguously, for example, MAGISTRATES COURT. Sometimes the name will be a blend of distinctive and descriptive naming, for example, RAILWAY TAVERN (PUBLIC HOUSE) or THE COURT ROYAL (HOTEL).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 110
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The alternateLanguageNumber gives a unique numeric identifier for addresses on each street, for example, '11' (per Local Authority Street Naming and Numbering conventions). Numbers that contain a range, decimals or non-numeric characters do not appear in this field but will be found in the Name or the subName attributes.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 13
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name, number or descriptor that identifies the nearest accessable street that an Address is located on or close to, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla).
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 100
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Name of the area or geographical identifier within a town, settlement, village or hamlet that an address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). For example, a locality may be a suburb, housing estate or commercial estate.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The name of the settlement that the address is located within, defined in either Welsh (cym) or Gaelic / Scottish Gaelic (gla). A settlement can be a City, Town, Village, Hamlet or Parish.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the island upon which an Address is located. Note: This attribute is currently only populated in the OS NGD Islands Address Collection.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 50
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
ISO 3166-3 Language Code for Welsh or Gaelic / Scottish Gaelic.
Data Types: String (GPKG), String (CSV)
Nullable: true
Code List Name: languagevalue
Max Length: 3
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Concatenation of the following alternate language address components: organisation (Pre-Build and Built Address Feature Types only), alternatelanguagesubname and / or alternatelanguagename and / or alternatelanguagenumber, alternatelanguagestreetname, alternatelanguagelocality, alternatelanguagetownname, alternatelanguageislandname and postcodelocator.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 500
OS Select+Build Filterable: No
Data Schema Version: 2.0
Floor level represents either: the access point to the Address, or the floor level or levels that the Address is located on fully occupies or represents occupiable space within the property.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 30
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the first value provided will be taken as the lowest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Lowest Floor Level is -1. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Lowest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, lowestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
In cases where the Floor Level attribute contains a list of floor levels (for example, where a commercial organisation occupies multiple levels within a building), the last value provided will be taken as the highest floor level. For example, where Floor Level attribute values are given as -1, 0, 1, 2, 3, the Highest Floor Level is 3. Mezzanine levels may be represented by a partial number, for example, 1.5. If the Floor Level attribute only contains one value, that value will also be used by the Highest Floor Level attribute.
This attribute is derived from Floor Level attribute data. Where the floorlevel field is NULL, highestfloorlevel values will also be NULL.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 3
Scale: 1
OS Select+Build Filterable: No
Data Schema Version: 2.0
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 6
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the AddressBase Product Support page of the OS website.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 230
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
A descriptive term used to describe the primary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the secondary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term used to describe the tertiary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A descriptive term or collection of terms used to describe the quaternary classification code of this address.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 120
OS Select+Build Filterable: No
Data Schema Version: 2.0
A description of the build status of the land and property unit represented by an Address, for example, 'Built In Use'.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: buildstatusvalue
Max Length: 12
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Date when the land and property unit entered the lifecycle state given in 'buildStatus'.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The lifecycle status of a given Address, for example, Prebuild, Built or Historic.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressstatusvalue
Max Length: 11
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Identifies the source of the postcode assigned to an address. This attribute can be used to identify properties capable of recieving mail as defined by Royal Mail for PAF matched address records, or as defined by Local Authorities for records which are not PAF matched but which are believed to be capable of receiving mail. For example, flats behind a front door with single letter box.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: addressbasepostalvalue
Max Length: 75
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Unique Property Reference Number (UPRN) of the parent record if a parent-child relationship exists.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the root UPRN will display the Unique Property Reference Number (UPRN) for the top level AddressableObject in the parent-child structure, which in this example is the Grandparent UPRN.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
In instances where an address sits in a hierarchy (for example, Child UPRN – Parent UPRN – Grandparent UPRN), the Hierarchy Level attribute will describe the position of the given UPRN within the overall set of relationships. Using a flat within a Halls of Residence Block in a University as an example, this would be described in the following way: FLAT 1 is the Child UPRN at the lowest level and its hierarchy level will be 3; its parent UPRN is BLOCK H, which will have a hierarchy level of 2; BLOCK H has, in turn, a Parent UPRN of EXETER UNIVERSITY, which will have a hierarchy level of 1.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The Unique Street Reference Number (USRN), a unique and persistent identifier of a Street which is assigned by the Roads or Highway Authority.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Description of the type of match made between the Unique Property Reference Number (UPRN) and its Unique Street Reference Number (USRN). A value of 1 is matched manually to the most accessible USRN, and a value of 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: usrnmatchindicatorvalue
Max Length: 17
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Numeric code identifying the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: Integer (GPKG), Integer (CSV)
Nullable: false
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
Name of the authority responsible for assigning the Unique Property Reference Number (UPRN), creating the address record and maintaining the address record.
Data Types: String (GPKG), String (CSV)
Nullable: false
Max Length: 35
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The Office for National Statistics Governmental Statistical Service (GSS) code representing the lower tier local authority.
Data Types: String (GPKG), String (CSV)
Nullable: true
Max Length: 9
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
X coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 8
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Y coordinate defining the position of the object in accordance with the British National Grid (EPSG:27700) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: true
Precision: 9
Scale: 2
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the latitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Value defining the longitude of the Address location in accordance with the ETRS89 (EPSG:4258) coordinate reference system.
Data Types: Float (GPKG), Real (CSV)
Nullable: false
Precision: 9
Scale: 7
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry for the feature.
Data Types: Geometry (GPKG), WKT (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
Geometry Type: Point
Local Authority assigned value giving a description of the accuracy of the coordinate position allocated to the Address location, for example, 'Central Internal Position' of a building.
Data Types: String (GPKG), String (CSV)
Nullable: false
Code List Name: positionalaccuracyvalue
Max Length: 25
OS Select+Build Filterable: Yes
Data Schema Version: 1.0, 2.0
The date on which this record was inserted into the Local Authority database.
Data Types: Date (GPKG), Date (CSV)
Nullable: false
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
The date on which the record ceased to exist.
Data Types: Date (GPKG), Date (CSV)
Nullable: true
OS Select+Build Filterable: No
Data Schema Version: 1.0, 2.0
This page highlights the changes which have been introduced when releasing a new data schema version within the OS NGD Address Theme.
The in the Core Principles section has more in-depth information about how data schema versioning works in the OS NGD.
The following feature types in the GB Address and Islands Address Collections are now available as data schema version 2.0:
Built Address
Historic Address
Non-Addressable Object
Pre-Build Address
New attributes have been added to these OS NGD Address feature types and improvements have been implemented regarding the consistency of address positioning, usage classifications, business names, and address lifecycle.
The following new attributes have been added:
| Attribute name | Data type |
|---|
More information on the new attributes is available on the individual feature type pages.
Please note, when accessing any of the data schema version 2.0 feature types mentioned above, the Related Components provided with these feature types have also been updated, as documented below.
Code List Name:
Code List Name:
Alphanumeric code used to classify the object using the AddressBase Classification Scheme, which is available to download from the .
Description of the classification code as defined in the AddressBase Classification Scheme, which is available to download from the .
Code List Name:
The also now has the following additional attributes:
| Attribute name | Data type |
|---|
The also now has the following additional attributes:
| Attribute name | Data type |
|---|
1.0
02 November 2022
Ongoing
2.0
28 March 2023
Ongoing
1.0
02 November 2022
Ongoing
2.0
28 March 2023
Ongoing
1.0
02 November 2022
Ongoing
2.0
28 March 2023
Ongoing
1.0
02 November 2022
Ongoing
2.0
28 March 2023
Ongoing
Full Address | string |
Lowest Floor Level | numeric |
Highest Floor Level | numeric |
Effective Start Date | date |
Effective End Date | date |
Full Address | string |
Lowest Floor Level | numeric |
Highest Floor Level | numeric |
Primary Classification Description | string |
Secondary Classification Description | string |
Tertiary Classification Description | string |
Quaternary Classification Description | string |
