Skip to main content

AddressBase Core

Essential Elements​

ID​

idstring

Global unique internally generated identifier for an address

Example
paf_8387729

Dataset​

datasetstring

Indicates the provenance of an address

Values
  • "ab"

Language​

language

Schema not found.

Address Line 1​

line_1string

First Address Line. Often contains premise and thoroughfare information. In the case of a commercial premise, the first line is always the full name of the registered organisation. Never empty.

Example
Prime Minister & First Lord of Treasury

Address Line 2​

line_2string

Second Address Line. Often contains thoroughfare and locality information. May be empty

Example
10 Downing Street

Address Line 3​

line_3string

Third address line. May be empty.

Premise​

premisestring

A pre-computed string which sensibly combines building_number, building_name and sub_building_name. building_number, building_name and sub_building_name represent raw data from Royal Mail's and can be difficult to parse if you are unaware of how the Postcode Address File premise fields work together. For this reason, we also provide a pre-computed premise field which intelligently gathers these points into a single, simple premise string. This field is ideal if you want to pull premise information and thoroughfare information separately instead of using our address lines data.

Example
10

UPRN​

uprnstring

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

UDPRN​

udprnnumber

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

PARENT_UPRN​

parent_uprnstring

UPRN of the parent Record if a parent-child relationship exists.

USRN​

usrnnumber

Unique Street Reference Number assigned by the Street Name and Numbering Custodian OR Ordnance Survey depending on the address record.

TOID​

toidstring

The Topographic Identifier taken from OS MasterMap Topography Layer. This TOID is assigned to the UPRN by performing a spatial intersection between the two identifiers. It consists of the letters 'osgb' and is followed by up to sixteen digits.

Classification Code​

classification_codestring

A code that describes the classification of the address record to a maximum of a secondary level.

Easting​

eastingsnumber

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

Northing​

northingsnumber

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

Latitude​

latitudenumber

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

Longitude​

longitudenumber

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

Single Line Address​

single_address_linestring

A single attribute containing text concatenation of the address elements separated by a comma.

Street Name​

street_namestring

Street / Road name for the address record.

Locality​

localitystring

A locality defines an area or geographical identifier within a town, village, or hamlet. Locality represents the lower level geographical area. The locality field should be used in conjunction with the town name and street description fields to uniquely identify geographic area where there may be more than one within an administrative area.

Town Name​

town_namestring

Geographical town name assigned by the Local Authority. Please note this can be different from the Post Town value assigned by Royal Mail.

Delivery Point Suffix​

delivery_point_suffixstring

A two-character code uniquely identifying an individual delivery point within a postcode, assigned by Royal Mail.

Post Town​

post_townstring

The town or city in which the Royal Mail sorting office is located which services this address record.

Condition: POST_TOWN is not populated if this is the same as TOWN_NAME.

Governmental Statistical Service​

gss_codestring

The Office for National Statistics Governmental Statistical Service (GSS) code representing the contributing Local Authority.

Representative Point Code​

rpcnumber

Representative Point Code describes the accuracy of the coordinate that has been allocated to the UPRN as indicated by the Local Authority and enhanced using large scale OS data.

Last Update Date​

last_update_datestring

The latest date on which any of the attributes on this record were last changed.

Format
date

Island​

islandstring

Third level of geographic area name to record island names where appropriate.

Change Code​

change_codestring

This enumeration is used in association with the attribute “CHANGE_CODE”. This enumeration identifies the type of change that has been made to a feature. The change type must be set when a feature is inserted, updated, or deleted. Please see section 3 for more information. Example I = Insert, U = Update, D = Delete

Values
  • "I"
  • "U"
  • "D"

Building Name​

building_namestring

The building name is a description applied to a single address or a group of addresses.

Building Number​

building_numberstring

The building number is a number or range of numbers given to a single address or a group of addresses.

Sub-building​

sub_buildingstring

The sub-building name and/or number for the address record.

Postcode​

postcodestring

A postcode assigned by Royal Mail for the address record.

PO Box​

po_boxstring

Text concatenation of 'PO BOX' and the Post Office Box (PO Box) number or 'BFPO' and the British Forces Post Office number.

Organisation​

organisationstring

The organisation name is the business name given, when appropriate, to an address record.

Country​

countrystring

Full country names (ISO 3166)

Example
England

Country ISO​

country_isostring

3 letter country code (ISO 3166-1)

County​

countystring

Since postal, administrative or traditional counties may not apply to some addresses, the county field is designed to return whatever county data is available. Normally, the postal county is returned. If this is not present, the county field will fall back to the administrative county. If the administrative county is also not present, the county field will fall back to the traditional county. May be empty in cases where no administrative, postal or traditional county present.

Example
London

District​

districtstring

A district is a type of administrative division that is managed by the local authorities.

Ward​

wardstring

The current administrative/electoral area to which the postcode has been assigned. May be empty for a small number of addresses.

Example
St. James'

Traditional County​

traditional_countystring

Traditional counties are provided by the Association of British Counties. It is historical data, and can date from the 1800s. May be empty.

Example
Greater London

Postal County​

postal_countystring

Postal counties were used for the distribution of mail before the Postcode system was introduced in the 1970s. The Former Postal County was the Administrative County at the time. This data rarely changes. May be empty.

Example
London