OS Docs HomeOS NGDOS APIsMore than MapsOS Data HubProduct Refresh Dates

Address

The address of a property or object which is defined as the main/preferred address by the Local Land and Property Gazetteer (LLPG) custodian, Ordnance Survey or Royal Mail.

Feature type attributes

The following page provides details about the attributes included with this feature, their data types in the different output formats, and other important metadata about them.

UPRN

Unique Property Reference Number (UPRN) assigned by the LLPG Custodian or Ordnance Survey.

  • Attribute Name: uprn (GML), UPRN (CSV)

  • Data Type: Integer

  • Size: 12

  • Multiplicity: [1]

  • Source: Contributing Local Authority / Ordnance Survey

UDPRN

Royal Mail’s Unique Delivery Point Reference Number (UDPRN).

  • Attribute Name: udprn (GML), UDPRN (CSV)

  • Data Type: Integer

  • Size: 8

  • Multiplicity: [0..1]

  • Source: Royal Mail

Change type

Type of Record Change – please see COU supply for more information.

  • Attribute Name: changeType (GML), CHANGE_TYPE (CSV)

  • Code List Name: ChangeTypeCode

  • Size: 1

  • Multiplicity: [1]

State

A code identifying the current state of the property.

  • Attribute Name: state (GML), STATE (CSV)

  • Code List Name: StateCode

  • Size: 1

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

State date

Date on which the property achieved its current state in the real world in the CCYY-MM-DD format.

  • Attribute Name: stateDate (GML), STATE_DATE (CSV)

  • Condition: State Date must be present if State is present.

  • Data Type: Date

  • Size: 1

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Class

Classification of the address record.

  • Attribute Name: class (GML), CLASS (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 6

  • Multiplicity: [1]

  • Source: Contributing Local Authority

Parent UPRN

UPRN of the parent record if a parent child relationship exists.

  • Attribute Name: class (GML), CLASS (CSV)

  • Data Type: Integer

  • Size: 12

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Position

A value in metres defining the x and y location in accordance with the British National Grid.

  • Attribute Name: position (GML), X_COORDINATE, Y_COORDINATE (CSV)

  • Data Type: GM_Point (GML), Float (CSV)

  • Size: X_COORDINATE (precision, scale) – (8, 2), Y_COORDINATE (precision, scale) – (9, 2)

  • Multiplicity: [1]

  • Source: Contributing Local Authority/Ordnance Survey

Position lat long

A value defining the Longitude and Latitude location in accordance with the ETRS89 coordinate reference system.

  • Attribute Name: positionLatLong (GML), LATITUDE, LONGITUDE (CSV)

  • Data Type: GM_Point (GML), Float (CSV)

  • Size: LATITUDE (precision, scale) – (9, 7), LONGITUDE (precision, scale) – (8, 7)

  • Multiplicity: [1]

  • Source: Ordnance Survey

RPC

Representative Point Code. This code is used to reflect positional accuracy.

  • Attribute Name: rpc (GML), RPC (CSV)

  • Code List Name: RPCCode

  • Size: 1

  • Multiplicity: [1]

  • Source: Contributing Local Authority

Local custodian code

Unique identifier of the LLPG Custodian.

  • Attribute Name: localCustodianCode (GML), LOCAL_CUSTODIAN_CODE (CSV)

  • Data Type: Integer

  • Size: 4

  • Multiplicity: [1]

Country

The country in which a record can be found.

  • Attribute Name: country (GML), COUNTRY (CSV)

  • Code List Name: CountryCode

  • Size: 1

  • Multiplicity: [1]

LA start date

The date on which the address record was inserted into the database in the CCYY-MM-DD format.

  • Attribute Name: laStartDate (GML), LA_START_DATE (CSV)

  • Data Type: Date

  • Multiplicity: [1]

  • Source: Contributing Local Authority

Last update date

The date on which any of the attributes on this record were last changed in the CCYY-MM-DD format.

  • Attribute Name: lastUpdateDate (GML), LAST_UPDATE_DATE (CSV)

  • Data Type: Date

  • Multiplicity: [1]

Entry date

The date on which the record was inserted into the Local Authority database in the CCYY-MM-DD format.

  • Attribute Name: entryDate (GML), ENTRY_DATE (CSV)

  • Data Type: Date

  • Multiplicity: [1]

  • Source: Contributing Local Authority.

RM organisation name

The organisation name is the business name given to a delivery point 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.

  • Attribute Name: rmOrganisationName (GML), RM_ORGANISATION_NAME (CSV)

  • Condition:

    • Organisation Name or PO Box Number must be present if Building Name or Building Number are all not present.

    • RM Organisation Name must be present if Department Name is present.

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 60

  • Multiplicity: [0..1]

  • Source: Royal Mail

LA organisation

Name of current occupier as provided by the Local Authority Custodian.

  • Attribute Name: laOrganisation (GML), LA_ORGANISATION (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 100

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Department name

For some organisations, department name is indicated because mail is received by subdivisions of the main organisation at distinct delivery points. For example, Organisation Name: ABC COMMUNICATIONS or RM Department Name: MARKETING DEPARTMENT

  • Attribute Name: departmentName (GML), DEPARTMENT_NAME (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 60

  • Multiplicity: [0..1]

  • Source: Royal Mail

Legal name

Registered legal name of the organisation.

  • Attribute Name: legaltName (GML), LEGAL_NAME (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 60

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Sub building name

The sub-building name and/or number are identifiers for subdivisions of properties.

For example:

Sub-building Name: FLAT 3 Building Name: POPLAR COURT Thoroughfare: LONDON ROAD

If the above address is styled 3 POPLAR COURT, all the text will be shown in the Building Name attribute and the Sub-building Name will be empty. The building number will be shown in this field when it contains a range, decimal or non-numeric character (see Building Number).

  • Attribute Name: subBuildingName (GML), SUB_BUILDING_NAME (CSV)

  • Condition: If a Sub Building Name is present, a Building Name or Building Number must also be present.

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 30

  • Multiplicity: [0..1]

  • Source: Royal Mail

Building name

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

  • Attribute Name: buildingName (GML), BUILDING_NAME (CSV)

  • Condition: Building Name must be present if RM Organisation Name or Building Number or PO Box Number are all not present.

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 50

  • Multiplicity: [0..1]

  • Source: Royal Mail

Building number

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 buildingName or the sub-BuildingName fields.

  • Attribute Name: buildingNumber (GML), BUILDING_NUMBER (CSV)

  • Condition: Building Number must be present if Organisation Name or Building Name or PO Box Number are all not present.

  • Data Type: Integer

  • Size: 4

  • Multiplicity: [0..1]

  • Source: Royal Mail

SAO start number

The number of the secondary addressable object (SAO) or the start of the number range.

  • Attribute Name: saoStartNumber (GML), SAO_START_NUMBER (CSV)

  • Condition: If a SAO Start Number is present a PAO Start Number or PAO text must also be present.

  • Data Type: Integer

  • Size: 4

  • Multiplicity: [0..1]

SAO start suffix

The suffix to the SAO_START_NUMBER.

  • Attribute Name: saoStartSuffix (GML), SAO_START_SUFFIX (CSV)

  • Condition: If a SAO Start Suffix is present a SAO Start Number must also be present.

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 2

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

SAO end number

The end of the number range for the SAO, where the SAO_START_NUMBER contains the first number in the range.

  • Attribute Name: saoEndNumber (GML), SAO_END_NUMBER (CSV)

  • Condition: If SAO End Number is present, a SAO Start Number must also be present.

  • Data Type: Integer

  • Size: 4

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

SAO end suffix

The suffix to the SAO_END_NUMBER.

  • Attribute Name: saoEndSuffix (GML), SAO_END_SUFFIX (CSV)

  • Condition: If a SAO End Suffix is present, a SAO End Number must also be present.

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 2

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

SAO text

Describes the SAO, such as Maisonette.

  • Attribute Name: saoText (GML), SAO_TEXT (CSV)

  • Condition: If SAO Text is present, a PAO Start Number or PAO Text must also be present.

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 90

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Alt language SAO text

Describes the SAO, such as Maisonette.

  • Attribute Name: altLanguageSAOText (GML), ALT_LANGUAGE_SAO_TEXT (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 90

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

PAO start number

The number of the primary addressable object (PAO) or the start of the number range.

  • Attribute Name: paoStartNumber (GML), PAO_START_NUMBER (CSV)

  • Condition: PAO Start Number must be present if PAO Text is not present.

  • Data Type: Integer

  • Size: 4

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

PAO start suffix

The suffix to the PAO_START_NUMBER.

  • Attribute Name: paoStartSuffix (GML), PAO_START_SUFFIX (CSV)

  • Condition: If a PAO Start Suffix is present, a PAO Start Number must also be present.

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 2

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

PAO end number

The end of the number range for the PAO where the PAO_START_NUMBER contains the first number in the range.

  • Attribute Name: paoEndNumber (GML), PAO_END_NUMBER (CSV)

  • Condition: If a PAO End Number is present, a PAO Start Number must also be present.

  • Data Type: Integer

  • Size: 4

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

PAO end suffix

The suffix to the PAO end number.

  • Attribute Name: paoEndSuffix (GML), PAO_END_SUFFIX (CSV)

  • Condition: If a PAO End Suffix is present, a PAO End Number must also be present.

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 2

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

PAO text

Name describing the PAO, such as Sunrise Towers.

  • Attribute Name: paoText (GML), PAO_TEXT (CSV)

  • Condition: PAO Text must be present if PAO Start Number is not present.

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 90

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Alt language PAO text

Name describing the PAO, such as Sunrise Towers, in an alternative language.

  • Attribute Name: altLanguagePAOText (GML), ALT_LANGUAGE_PAO_TEXT (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 90

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

USRN

Unique Street Reference Number (USRN).

  • Attribute Name: usrn (GML), USRN (CSV)

  • Data Type: Integer

  • Size: 8

  • Multiplicity: [1]

  • Source: Contributing Local Authority

USRN match indicator

This field indicates how the item was matched to a Street. 1 is matched manually to the most accessible USRN and 2 is matched spatially to the nearest USRN, which may not be the nearest accessible street.

  • Attribute Name: usrnMatchIndicator (GML), USRN_MATCH_INDICATOR (CSV)

  • Code List Name: USRNMatchIndicatorCode

  • Size: 1

  • Multiplicity: [1]

  • Source: Contributing Local Authority/Ordnance Survey

Area name

Third level of geographic area name, for example, to record island names or property groups such as crofts.

  • Attribute Name: areaName (GML), AREA_NAME (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 40

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Level

Memorandum of the vertical position of the property.

  • Attribute Name: level (GML), LEVEL (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 30

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Official flag

Status of the Address.

  • Attribute Name: officialFlag (GML), OFFICIAL_FLAG (CSV)

  • Code List Name: OfficialFlagCode

  • Size: 1

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

OS address TOID

Unique identifier provided by Ordnance Survey.

  • Attribute Name: osAddressTOID (GML), OS_ADDRESS_TOID (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 20

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

OS address TOID version

The version of the OS Address TOID that the product relates to.

  • Attribute Name: osAddressTOIDVersion (GML), OS_ADDRESS_TOID_VERSION (CSV)

  • Condition: OS Address TOID Version must be present if OS Address TOID is present.

  • Data Type: Integer

  • Size: 3

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

OS road link TOID

The OS MasterMap Highways Network road link that the addressable object refers to.

  • Attribute Name: osRoadLinkTOID (GML), OS_ROADLINK_TOID (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 20

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

OS road link TOID version

The version of the OS Road Link TOID the product relates to.

  • Attribute Name: osAddressTOIDVersion (GML), OS_ADDRESS_TOID_VERSION (CSV)

  • Condition: OS Roadlink TOID Version must be present if OS Road Link TOID is present.

  • Data Type: Integer

  • Size: 3

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

OS topo TOID

The OS MasterMap Topography Layer TOID that the addressable object refers to.

  • Attribute Name: osTopoTOID (GML), OS_TOPO_TOID (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 20

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

OS topo TOID version

The version of the OS Topo TOID the product relates to.

  • Attribute Name: osTopoTOIDVersion (GML), OS_TOPO_TOID_VERSION (CSV)

  • Condition: OS Topo TOID Version must be present if OS Topo TOID is present.

  • Data Type: Integer

  • Size: 3

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

VOA CT record

The unique reference to the Valuation Office Agency (VOA) council tax record which the addressable object refers to.

  • Attribute Name: voaCTRecord (GML), VOA_CT_RECORD (CSV)

  • Data Type: Integer

  • Size: 50

  • Multiplicity: [0..1]

  • Source: Valuation Office Agency

VOA NDR record

The unique reference to the Valuation Office Agency (VOA) council tax record which the addressable object refers to.

  • Attribute Name: voaNDRRecord (GML), VOA_NDR_RECORD (CSV)

  • Data Type: Integer

  • Size: 50

  • Multiplicity: [0..1]

  • Source: Valuation Office Agency

Street description

Name taken from the Local Land and Property Gazetteer (LLPG) street name.

  • Attribute Name: streetDescription (GML), STREET_DESCRIPTION (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 100

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Alt language street description

Name taken from the LLPG street name in an alternative language.

  • Attribute Name: altLanguageStreetDescription (GML), ALT_LANGUAGE_STREET_DESCRIPTION (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 100

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Dependent thoroughfare

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.

  • Attribute Name: dependentThoroughfare (GML), DEPENDENT_THOROUGHFARE (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 80

  • Multiplicity: [0..1]

  • Source: Royal Mail

Thoroughfare

A thoroughfare in AddressBase is fundamentally a road, track or named access route on which there are Royal Mail delivery points, for example, HIGH STREET.

  • Attribute Name: thoroughfare (GML), THOROUGHFARE (CSV)

  • Condition: Thoroughfare must be present if dependent thoroughfare is present.

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 80

  • Multiplicity: [0..1]

  • Source: Royal Mail

Welsh dependent thoroughfare

The Welsh translation of DEPENDENT_THOROUGHFARE.

  • Attribute Name: welshDependentThoroughfare (GML), WELSH_DEPENDENT_THOROUGHFARE (CSV)

  • Condition: If a Welsh Dependent Thoroughfare is present, a Welsh Thoroughfare must also be present.

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Size: 80

  • Multiplicity: [0..1]

  • Source: Royal Mail

Welsh thoroughfare

The Welsh translation of THOROUGHFARE.

  • Attribute Name: welshThoroughfare (GML), WELSH_THOROUGHFARE (CSV)

  • Data Type: LocalisedCharacterString (GML), char (CSV)

  • Multiplicity: [0..1]

  • Size: 80

  • Source: Royal Mail

Double dependent locality

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.

  • Attribute Name: doubleDependentLocality (GML), DOUBLE_DEPENDENT_LOCALITY (CSV)

  • Condition: If a Double Dependent Locality is present, a Dependent Locality must also be present.

  • Data Types: LocalisedCharacterString (GML), char (CSV)

  • Size: 35

  • Multiplicity: [0..1]

  • Source: Royal Mail

Dependent locality

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.

  • Attribute Name: dependentLocality (GML), DEPENDENT_LOCALITY (CSV)

  • Data Types: LocalisedCharacterString (GML), char (CSV)

  • Size: 35

  • Multiplicity: [0..1]

  • Source: Royal Mail

Locality

A locality defines an area or geographical identifier within a town, village or hamlet.

  • Attribute Name: locality (GML), LOCALITY (CSV)

  • Data Types: LocalisedCharacterString (GML), char (CSV)

  • Size: 35

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Welsh dependent locality

The Welsh translation of DEPENDENT_LOCALITY.

  • Attribute Name: welshDependentLocality (GML), WELSH_DEPENDENT_LOCALITY (CSV)

  • Data Types: LocalisedCharacterString (GML), char (CSV)

  • Size: 35

  • Multiplicity: [0..1]

  • Source: Royal Mail

Welsh double dependent locality

The Welsh translation of Double Dependent Locality.

  • Attribute Name: welshDoubleDependentLocality (GML), WELSH_DOUBLE_DEPENDENT_LOCALITY (CSV)

  • Condition: If a Welsh Double Dependent Locality is present, a Welsh Dependent Locality must also be present.

  • Data Types: LocalisedCharacterString (GML), char (CSV)

  • Size: 35

  • Multiplicity: [0..1]

  • Source: Royal Mail

Town name

The name of the town the address is within.

  • Attribute Name: townName (GML), TOWN_NAME (CSV)

  • Data Types: CharacterString (GML), char (CSV)

  • Size: 30

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

Administrative area

Local Highway Authority name.

  • Attribute Name: administrativeArea (GML), ADMINISTRATIVE_AREA (CSV)

  • Data Types: CharacterString (GML), char (CSV)

  • Size: 30

  • Multiplicity: [1]

  • Source: Contributing Local Authority

Post town

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.

  • Attribute Name: postTown (GML), POST_TOWN (CSV)

  • Condition: Post Town must be present if Royal Mail’s Unique Delivery Point Reference Number (UDPRN) is present.

  • Data Types: LocalisedCharacterString (GML), char (CSV)

  • Size: 35

  • Multiplicity: [0..1]

  • Source: Royal Mail

Welsh post town

The Welsh translation of post town value.

  • Attribute Name: welshPostTown (GML), WELSH_POST_TOWN (CSV).

  • Data Types: LocalisedCharacterString (GML), char (CSV)

  • Size: 30

  • Multiplicity: [0..1]

  • Source: Royal Mail

Postcode

A postcode is an abbreviated form of address made up of combinations of between five and seven alphanumeric characters. These are used by Royal Mail to help with the automated sorting of mail. A postcode may cover between 1 and 100 addresses.

There are two main components of a postcode, for example, NW6 4DP:

  • The outward code (or ‘outcode’). The first two–four characters of the postcode constituting the postcode area and the postcode district, for example, NW6. It is the part of the postcode that enables mail to be sent from the accepting office to the correct area for delivery.

  • The inward code (or ‘incode’). The last three characters of the postcode constituting the postcode sector and the postcode unit, example, 4DP. It is used to sort mail at the local delivery office.

  • Attribute Name: postcode (GML), POSTCODE (CSV)

  • Condition: Postcode must be present if Royal Mail’s Unique Delivery Point Reference Number (UDPRN) is present.

  • Data Types: CharacterString (GML), char (CSV)

  • Size: 8

  • Multiplicity: [0..1]

  • Source: Royal Mail

Postcode locator

This field contains the Royal Mail Postcode Address File (PAF) postcode where the local authority address has been matched to PAF, that is, the POSTCODE field. Where a match has not been made, the postcode information is sourced from the local authority in collaboration with Royal Mail. Where the local authority does not hold a current valid postcode, Code-Point with Polygons is used to spatially derive the postcode based on the position of the coordinates.

This field is always assigned the Code-Point with Polygons Postcode for Street Records (Classification “PS”).

This field must be used in conjunction with the RPC field to determine the accuracy of its position.

  • Attribute Name: postcodeLocator (GML), POSTCODE_LOCATOR (CSV)

  • Data Types: CharacterString (GML), char (CSV)

  • Size: 8

  • Multiplicity: [1]

  • Source: Royal Mail, Contributing Local Authority or Ordnance Survey

Postcode type

Describes the address as a small or large user as defined by Royal Mail.

  • Attribute Name: postcodeType (GML), POSTCODE_TYPE (CSV)

  • Condition:

    • Postcode Type must be present if Royal Mail’s Unique Delivery Point Reference Number (UDPRN) is present.

    • Postcode Type Code must equal ‘L’ if PO Box Number is present.

  • Code List Name: PostcodeTypeCode

  • Size: 1

  • Multiplicity: [0..1]

  • Source: Royal Mail

Delivery point suffix

A two-character code uniquely identifying an individual delivery point within a postcode.

  • Attribute Name: deliveryPointSuffix (GML), DELIVERY_POINT_SUFFIX (CSV)

  • Condition: Delivery Point Suffix must be present if Royal Mail’s Unique Delivery Point Reference Number (UDPRN) is present.

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 2

  • Multiplicity: [0..1]

  • Source: Royal Mail

Addressbase postal

Identifies addresses which are believed to be capable of receiving mail as defined specifically for the AddressBase product and details their relationship with other AddressBase Postal records.

This field identifies some addresses which the AddressBase product believes to be capable of receiving mail which are not contained within the Royal Mail PAF database, such as flats behind a front door which has a single letter box.

  • Attribute Name: addressbasePostal (GML), ADDRESSBASE_POSTAL (CSV)

  • Condition: If AddressBase Postal value is ‘D’, UDPRN must be present.

  • Code List Name: AddressbasePostalCode

  • Size: 1

  • Multiplicity: [1]

  • Source: Royal Mail

PO Box number

Post Office Box (PO Box) number.

  • Attribute Name: poBoxNumber (GML), PO_BOX_NUMBER (CSV)

  • Condition: Organisation Name or PO Box Number must be present if Building Name or Building Number are all not present.

  • Data Types: CharacterString (GML), char (CSV)

  • Size: 6

  • Multiplicity: [0..1]

  • Source: Royal Mail

Ward code

The ONS GSS code of the electoral ward (England and Scotland) or the electoral division (Wales) name in which the property is situated, as assigned spatially from the latest Boundary-Line set. Boundary-Line ward boundary areas are produced directly from Statutory Instruments, which are authorised from the owning boundary changing bodies, namely, The Local Government and Parliamentary Boundary Commissions.

  • Attribute Name: wardCode (GML), WARD_CODE (CSV)

  • Condition: Organisation Name or PO Box Number must be present if Building Name or Building Number are all not present.

  • Data Types: CharacterString (GML), char (CSV)

  • Size: 9

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

Parish code

The ONS GSS code of the parish, town or community in which the property is situated, as assigned spatially from the latest Boundary-Line set. Boundary-Line parish boundary areas are produced directly from Statutory Instruments, which are authorised from the owning boundary changing bodies, namely, The Local Government and Parliamentary Boundary Commissions.

  • Attribute Name: parishCode (GML), PARISH_CODE (CSV)

  • Condition: Organisation Name or PO Box Number must be present if Building Name or Building Number are all not present.

  • Data Types: CharacterString (GML), char (CSV)

  • Size: 9

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

RM start date

Date on which the Royal Mail address was loaded into the NAG (National Address Gazetteer – as maintained by Geoplace) hub.

  • Attribute Name: rmStartDate (GML), RM_START_DATE (CSV)

  • Condition: RM Start Date must be present if Royal Mail’s Unique Delivery Point Reference Number (UDPRN) is present.

  • Data Types: Date

  • Multiplicity: [0..1]

  • Source: Royal Mail

Multi occ count

This is a count of all the child UPRNs for this record if a parent-child relationship exists.

  • Attribute Name: multiOccCount (GML), MULTI_OCC_COUNT (CSV)

  • Data Type: Integer

  • Size: 4

  • Multiplicity: [0..1]

  • Source: Ordnance Survey

VOA NDR primary description code

VOA non-domestic rates primary description code, for example, ‘IF2’.

The first letter is the primary category:

  • C = commercial

  • E = education

  • F = formula-assessed utility

  • I = industrial

  • L = leisure

  • M = miscellaneous

  • N = non-formula-assessed utility

  • T = Treasury (crown)

The second letter provides further detail, for example, O = office, F = factory.

The third and fourth digit is optional and occurs where further subdivision is required, for example, IF1 = mill, IF2 = works, IF3 = workshop and IF4 = business unit.

  • Attribute Name: voaNDRPDescCode (GML), VOA_NDR_DESC_CODE (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 5

  • Multiplicity: [0..1]

  • Source: Valuation Office Agency

VOA NDR scat code

VOA non-domestic rates special category code, for example, ‘016’.

While the Primary Description code above provides a general level of classification, there is a SCat code for every kind of premise that VOA rates. For example, within PDesc IF2 (industrial, factory, works) there are 009 (aluminium smelting works), 016 (artificial fibre works), 052 (cement works), 055 (chemical works), 110 (foundries), 142 (iron and/or steel works), 192 (motor vehicle works) and 198 (newspaper printing works).

  • Attribute Name: voaNDRPScatCode (GML), VOA_NDR_SCAT_CODE (CSV)

  • Data Type: CharacterString (GML), char (CSV)

  • Size: 4

  • Multiplicity: [0..1]

  • Source: Valuation Office Agency

Alt language

Field describing the language of the alternative records.

  • Attribute Name: altLanguage (GML), ALT_LANGUAGE (CSV)

  • Code List Name: LanguageCode

  • Size: 3

  • Multiplicity: [0..1]

  • Source: Contributing Local Authority

PreviousFeature typesNextAddressBase Supply Set

Last updated