# AddressBase Core

## Essential Elements[​](#essential-elements "Direct link to Essential Elements")

### ID[​](#id "Direct link to ID")

`id`string

Global unique internally generated identifier for an address

* Example

  `paf_8387729`

***

### Dataset[​](#dataset "Direct link to Dataset")

`dataset`string

Indicates the provenance of an address

* Values

  * "ab"

***

### Language[​](#language "Direct link to Language")

`language`

Schema not found.

***

### Address Line 1[​](#address-line-1 "Direct link to Address Line 1")

`line_1`string

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[​](#address-line-2 "Direct link to Address Line 2")

`line_2`string

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

* Example

  `10 Downing Street`

***

### Address Line 3[​](#address-line-3 "Direct link to Address Line 3")

`line_3`string

Third address line. May be empty.

***

### Premise[​](#premise "Direct link to Premise")

`premise`string

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[​](#uprn "Direct link to UPRN")

`uprn`string

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

***

### UDPRN[​](#udprn "Direct link to UDPRN")

`udprn`number

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

***

### PARENT\_UPRN[​](#parent_uprn "Direct link to PARENT_UPRN")

`parent_uprn`string

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

***

### USRN[​](#usrn "Direct link to USRN")

`usrn`number

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

***

### TOID[​](#toid "Direct link to TOID")

`toid`string

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-code "Direct link to Classification Code")

`classification_code`string

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

***

### Easting[​](#easting "Direct link to Easting")

`eastings`number

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

***

### Northing[​](#northing "Direct link to Northing")

`northings`number

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

***

### Latitude[​](#latitude "Direct link to Latitude")

`latitude`number

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

***

### Longitude[​](#longitude "Direct link to Longitude")

`longitude`number

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

***

### Single Line Address[​](#single-line-address "Direct link to Single Line Address")

`single_address_line`string

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

***

### Street Name[​](#street-name "Direct link to Street Name")

`street_name`string

Street / Road name for the address record.

***

### Locality[​](#locality "Direct link to Locality")

`locality`string

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-name "Direct link to Town Name")

`town_name`string

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-suffix "Direct link to Delivery Point Suffix")

`delivery_point_suffix`string

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

***

### Post Town[​](#post-town "Direct link to Post Town")

`post_town`string

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[​](#governmental-statistical-service "Direct link to Governmental Statistical Service")

`gss_code`string

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

***

### Representative Point Code[​](#representative-point-code "Direct link to Representative Point Code")

`rpc`number

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-date "Direct link to Last Update Date")

`last_update_date`string

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

* Format

  `date`

***

### Island[​](#island "Direct link to Island")

`island`string

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

***

### Change Code[​](#change-code "Direct link to Change Code")

`change_code`string

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-name "Direct link to Building Name")

`building_name`string

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

***

### Building Number[​](#building-number "Direct link to Building Number")

`building_number`string

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

***

### Sub-building[​](#sub-building "Direct link to Sub-building")

`sub_building`string

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

***

### Postcode[​](#postcode "Direct link to Postcode")

`postcode`string

A postcode assigned by Royal Mail for the address record.

***

### PO Box[​](#po-box "Direct link to PO Box")

`po_box`string

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

***

### Organisation[​](#organisation "Direct link to Organisation")

`organisation`string

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

***

### Country[​](#country "Direct link to Country")

`country`string

Full country names (ISO 3166)

* Example

  `England`

***

### Country ISO[​](#country-iso "Direct link to Country ISO")

`country_iso`string

3 letter country code (ISO 3166-1)

***

### County[​](#county "Direct link to County")

`county`string

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[​](#district "Direct link to District")

`district`string

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

***

### Ward[​](#ward "Direct link to Ward")

`ward`string

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-county "Direct link to Traditional County")

`traditional_county`string

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-county "Direct link to Postal County")

`postal_county`string

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`