> For the complete documentation index, see [llms.txt](https://docs.os.uk/osngd/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.os.uk/osngd/data-structure/address/islands-address/royal-mail-address.md).

# Royal Mail Address

{% hint style="warning" %}
This page details upcoming data that will be provided for the Royal Mail Address Feature Type in the OS NGD from the start of October 2026 to give you early insight. Data schema versions 1.1 and 2.0 for this feature type are currently not available via OS Select+Build (the bespoke OS NGD data download service). The information on this page is as accurate as possible but is subject to change before launch.
{% endhint %}

The Royal Mail Address Feature Type provides Royal Mail delivery point addresses, a point geometry and information describing the relationship they have with local authority addresses.

## Data schema versioning

The following table provides details about this feature type’s data schema versions, including the reasons behind the changes and the related launch date when each version went live.&#x20;

### :arrows\_clockwise: Data schema version table

<table><thead><tr><th width="82.40008544921875">Version ↓</th><th width="159.933349609375">Launch Date</th><th width="160.466552734375">Latest Date</th><th>Change</th></tr></thead><tbody><tr><td>2.0</td><td>01 October 2026</td><td><code>Ongoing</code></td><td><p>Major version increment. New attribution added for Full Address, Country, Primary UPRN Match, Postcode Area, Postcode District, Postcode Sector, PIF (Postcode Information File) Checksum Digit and PIF Display Text.</p><p></p><p>The Postcode, Post Town, Welsh Post Town, Geometry Allocation Method and Positional Accuracy attributes are now filterable in OS Select+Build.</p><p></p><p>New Multiple Residence, Delivery Point Alias and Other Alias Related Components added.</p></td></tr><tr><td>1.1</td><td>01 October 2026</td><td><code>Ongoing</code></td><td>Minor version increment. Update to schema to make the Description attribute filterable in OS Select+Build.</td></tr><tr><td>1.0</td><td>30 September 2025</td><td>30 September 2026</td><td>Initial launch of the Royal Mail Address Feature Type.</td></tr></tbody></table>

Please see [Data schema versioning](/osngd/getting-started/os-ngd-fundamentals/data-schema-versioning.md) for in-depth information about data schema versioning in the OS NGD.

## Temporal filtering

Temporal filtering allows you to order a one-off snapshot of data from the OS NGD from a current or past date. It is an optional step when you create a new data package in OS Select+Build (the OS NGD download service).

The earliest and latest dates on which you can request a one-off snapshot of a date in the past for this feature type's data schema versions are indicated in the Data schema version table above. Please note that any data temporally filtered earlier than the specified launch date indicated in the table for the data schema versions may contain data inconsistencies.

More information about temporal filtering on OS NGD feature types is available from the [Getting started with temporal filtering guide](/osngd/getting-started/downloading-with-os-select+build/getting-started-with-data-packages/getting-started-with-temporal-filtering.md).

## Feature type attributes

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.

{% hint style="info" %}

## Loading OS NGD CSV files into databases

Comma-separated values (CSV) file format is universally supported for easy ingestion into all major database products. Before loading OS NGD data contained in CSV files into a database, it is necessary to create relevant tables. Data definition language (DDL) statements for PostgreSQL, SQL Server and Oracle can be accessed in our [OS NGD Resources GitHub repository](https://github.com/OrdnanceSurvey/osngd-resources/tree/main/database-resources).

For instructions on loading CSV files, see the [Getting Started with CSV](/osngd/getting-started/downloading-with-os-select+build/getting-started-with-csv.md) guide.
{% endhint %}

### udprn

Unique Delivery Point Reference Number (UDPRN) assigned by Royal Mail as a persistent identifier.

* **Data Types:** Integer (GPKG), Integer (CSV)
* **Nullable:** false
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### versiondate

Date when the version was last updated.

* **Data Types:** Date (GPKG), Date (CSV)
* **Nullable:** false
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### versionavailablefromdate

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.1, 2.0

### versionavailabletodate

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.1, 2.0

### changetype

The type of change that generated a new version of the feature.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [changetypevalue](/osngd/code-lists/code-lists-overview/changetypevalue.md)
* **Max Length:** 50
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### theme

The OS NGD theme to which this feature belongs.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [themevalue](/osngd/code-lists/code-lists-overview/themevalue.md)
* **Max Length:** 40
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### description

A single descriptive value intended for a quick understanding of what the feature represents.

{% tabs %}
{% tab title="v1.1, v2.0" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [royalmailaddressdescriptionvalue](/osngd/code-lists/code-lists-overview/royalmailaddressdescriptionvalue.md)
* **Max Length:** 50
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 1.1, 2.0
  {% endtab %}

{% tab title="v1.0" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [royalmailaddressdescriptionvalue](/osngd/code-lists/code-lists-overview/royalmailaddressdescriptionvalue.md)
* **Max Length:** 50
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.0
  {% endtab %}
  {% endtabs %}

### organisationname

The name of the organisation operating from the address.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 60
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### departmentname

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.1, 2.0

### subbuildingname

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.1, 2.0

### buildingname

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.1, 2.0

### buildingnumber

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 Sub Building Name fields.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 4
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### dependentthoroughfare

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.1, 2.0

### thoroughfare

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.1, 2.0

### doubledependentlocality

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.1, 2.0

### dependentlocality

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.1, 2.0

### posttown

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.

{% tabs %}
{% tab title="v2.0" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 30
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0
  {% endtab %}

{% tab title="v1.1" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 30
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1
  {% endtab %}
  {% endtabs %}

### postcode

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.

{% tabs %}
{% tab title="v2.0" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 8
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0
  {% endtab %}

{% tab title="v1.1" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 8
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1
  {% endtab %}
  {% endtabs %}

### :new: postcodearea

The postcode area is identified by one or two alpha characters at the start of the postcode, the letters being derived from a town, city or district falling within the postcode area. There are, at present, 124 postcode areas in Great Britain, for example, FK for Falkirk, CF for Cardiff and SO for Southampton. For more information about the postcode area, please consult chapter one 'Structure of a PAF address' of the [Royal Mail Programmer's Guide](https://www.poweredbypaf.com/resources/).

* **Data Types:** String (GeoJSON), String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 2
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0

### :new: postcodedistrict

The postcode district is identified by one or two alphanumeric characters following the postcode area, for example, FK1 for Falkirk, CF10 for Cardiff and SO16 for Southampton. For more information about the postcode district, please consult chapter one 'Structure of a PAF address' of the [Royal Mail Programmer's Guide](https://www.poweredbypaf.com/resources/).

{% hint style="info" %}

### Note

There are certain non-geographic districts. In these instances, a district code is allocated to cover all large users in the postcode area. For more information about the postcode, please consult chapter one 'Structure of a PAF address' of the [Royal Mail Programmer's Guide](https://www.poweredbypaf.com/resources/).
{% endhint %}

* **Data Types:** String (GeoJSON), String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 4
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0

### :new: postcodesector

The postcode sector is a sub-area of a postcode district. It's identified by one numeric character following the postcode district (with a space included), for example, FK1 1 for Falkirk, CF10 1 for Cardiff and SO16 1 for Southampton. For more information about the postcode sector, please consult chapter one 'Structure of a PAF address' of the [Royal Mail Programmer's Guide](https://www.poweredbypaf.com/resources/).

* **Data Types:** String (GeoJSON), String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 6
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0

### :new: pifchecksumdigit

A single numeric digit derived from the associated postcode. The Postcode Information File (PIF) Checksum Digit is derived from the postcode using the Royal Mail postcode checksum algorithm. The Checksum Digit is not part of the postcode itself and should not be represented as part of the postcode value. For more information about PIF attribution, please consult chapter 12 'Postcode Information File' of the [Royal Mail Programmer's Guide](https://www.poweredbypaf.com/resources/).

{% hint style="info" %}

### Note

All Postcode Address File (PAF) Mainfile addresses have associated Postcode Information File (PIF) attribution, although this attribution may present as null where the daily publication PAF Mainfile address has been created or edited and has not yet appeared in the subsequent monthly publication of PIF.

All PIF attribution will appear as null upon initial release of v2.0 of the Royal Mail Address Feature Type, with publication in the OS NGD expected to begin in 2027.
{% endhint %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 1
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### :new: pifdisplaytext

Details the delivery point address, described as either the relevant building number, or a string containing the most significant 50 characters of the delivery point description (as held as display text within the Postcode Address File – PAF). The Display Text Field will contain only the house number information unless properties do not have a house number, in which case the house name will appear. Where flats&#x20;occur, the relevant flat information from the PAF will appear. For organisations which appear&#x20;on the PAF, the organisation will appear on the Postcode Information File (PIF). For more information about PIF attribution, please consult chapter 12 'Postcode Information File' of the [Royal Mail Programmer's Guide](https://www.poweredbypaf.com/resources/).

{% hint style="info" %}

### Note

All Postcode Address File (PAF) Mainfile addresses have associated Postcode Information File (PIF) attribution, although this attribution may present as null where the daily publication PAF Mainfile address has been created or edited and has not yet appeared in the subsequent monthly publication of PIF.

All PIF attribution will appear as null upon initial release of v2.0 of the Royal Mail Address Feature Type, with publication in the OS NGD expected to begin in 2027.
{% endhint %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 50
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### postcodetype

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

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [postcodetypevalue](/osngd/code-lists/code-lists-overview/postcodetypevalue.md)
* **Max Length:** 10
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### :new: country

Name of the geographical territory that the Address is located within, where a geographical territory represents either a devolved country or an island nation. This is available only where the Royal Mail Postcode Address File (PAF) Address is matched to a Local Authority Unique Property Reference Number (UPRN).

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Code List Name:** [countryvalue](/osngd/code-lists/code-lists-overview/countryvalue.md)
* **Max Length:** 25
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0

### :new: fulladdress

Concatenation of the following address components: Organisation, Sub-Building Name and / or Building Name and / or Building Number, Thoroughfare, Locality, Post Town and Postcode.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Max Length:** 1 000
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 2.0

### deliverypointsuffix

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.1, 2.0

### welshdependentthoroughfare

The Welsh translation of Dependent Thoroughfare.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 80
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### welshthoroughfare

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.1, 2.0

### welshdoubledependentlocality

The Welsh translation of Double Dependent Locality.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 35
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### welshdependentlocality

The Welsh translation of Dependent Locality.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 35
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### welshposttown

The Welsh translation of Post Town.

{% tabs %}
{% tab title="v2.0" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 30
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0
  {% endtab %}

{% tab title="v1.1" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 30
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1
  {% endtab %}
  {% endtabs %}

### poboxnumber

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.1, 2.0

### updatedate

The date the Royal Mail record last changed.

* **Data Types:** Date (GPKG), Date (CSV)
* **Nullable:** false
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### entrydate

Date of the change file that first supplied the Royal Mail record.

* **Data Types:**  Date (GPKG), Date (CSV)
* **Nullable:** false
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### easting

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.1, 2.0

### northing

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.1, 2.0

### latitude

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.1, 2.0

### longitude

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.1, 2.0

### geometry

Geometry for the feature.

* **Data Types:** Geometry (GPKG), WKT (CSV)
* **Nullable:** false
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0
* **Geometry Type:** Point

### positionalaccuracy

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.

{% tabs %}
{% tab title="v2.0" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [positionalaccuracyvalue](/osngd/code-lists/code-lists-overview/positionalaccuracyvalue.md)
* **Code List Version:** 2.0&#x20;
* **Max Length:** 25
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0
  {% endtab %}

{% tab title="v1.1" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [positionalaccuracyvalue](/osngd/code-lists/code-lists-overview/positionalaccuracyvalue.md)
* **Code List Version:** 2.0&#x20;
* **Max Length:** 25
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1
  {% endtab %}
  {% endtabs %}

### geometryallocationmethod

Describes the method by which a geometry was allocated to the Royal Mail record. Where a Royal Mail record is matched to a Local Authority record, the geometry will be assigned from the matched record. Where a Royal Mail record cannot be directly matched, geometry will be assigned by reference to a parent record, a street, or records which share the postcode unit, sector, district or area – in the listed order of preference. Where none of the listed methods are available, the geometry will be allocated to an internal centre point for the Local Authority area or Island in which the Royal Mail address is located.

{% tabs %}
{% tab title="v2.0" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [geometryallocationmethodvalue](/osngd/code-lists/code-lists-overview/geometryallocationmethodvalue.md)
* **Max Length:** 25
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0
  {% endtab %}

{% tab title="v1.1" %}

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [geometryallocationmethodvalue](/osngd/code-lists/code-lists-overview/geometryallocationmethodvalue.md)
* **Max Length:** 25
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1
  {% endtab %}
  {% endtabs %}

### unmatchedreason

Describes the reason that the Royal Mail record has not been matched to a Local Authority record.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Max Length:** 100
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### unmatchedreasondate

The date on which the Unmatched Reason value was captured.

* **Data Types:** Date (GPKG), Date (CSV)
* **Nullable:** true
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### uprn

The Unique Property Reference Number (UPRN) to which a Unique Delivery Point Reference Number (UDPRN) has been matched.

* **Data Types:** Integer (GPKG), Integer (CSV)
* **Nullable:** true
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### matchedaddressfeaturetype

The feature type of the Unique Property Reference Number (UPRN) to which the Unique Delivery Point Reference Number (UDPRN) has been matched.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Code List Name:** [matchedaddressfeaturetypevalue](/osngd/code-lists/code-lists-overview/matchedaddressfeaturetypevalue.md)
* **Max Length:** 25
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 1.1, 2.0

### :new: primaryuprnmatch

Indicates whether a matched Local Authority Unique Property Reference Number (UPRN) is considered to be the primary match by GeoPlace and / or the relevant Local Authority. This attribute is particularly useful when a Unique Delivery Point Reference Number (UDPRN) is matched to multiple UPRNs as it will provide a one-to-one relationship between the UPRN and UDPRN.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Code List Name:** [yesnovalue](/osngd/code-lists/code-lists-overview/yesnovalue.md)
* **Max Length:** 3
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 2.0

### matchtype

A description of the relationship assigned between the Unique Delivery Point Reference Number (UDPRN) and the Unique Property Reference Number (UPRN). Where a Postcode Address File (PAF) record relates directly to a Local Authority record, this is set to ‘Direct.’ If a ‘Direct’ match cannot be found, a PAF record may be matched to a Parent, Neighbour or Street record in Local Authority data, in order to estimate a position for the PAF record.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** false
* **Code List Name:** [rmtolamatchtypevalue](/osngd/code-lists/code-lists-overview/rmtolamatchtypevalue.md)
* **Max Length:** 20
* **OS Select+Build Filterable:** Yes
* **Data Schema Version:** 1.1, 2.0

### matchdate

The date on which the match was made between the Unique Delivery Point Reference Number (UDPRN) and the Unique Property Reference Number (UPRN).

* **Data Types:** Date (GPKG), Date (CSV)
* **Nullable:** true
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### matchmethod

The method by which the match was made.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Code List Name:** [matchmethodvalue](/osngd/code-lists/code-lists-overview/matchmethodvalue.md)
* **Max Length:** 10
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0

### matchingorganisation

Describes the organisation which made the match between the Royal Mail record and the Local Authority record.

* **Data Types:** String (GPKG), String (CSV)
* **Nullable:** true
* **Code List Name:** [matchingorganisationvalue](/osngd/code-lists/code-lists-overview/matchingorganisationvalue.md)
* **Max Length:** 25
* **OS Select+Build Filterable:** No
* **Data Schema Version:** 1.1, 2.0


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.os.uk/osngd/data-structure/address/islands-address/royal-mail-address.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
