> For the complete documentation index, see [llms.txt](https://docs.os.uk/os-downloads/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/os-downloads/products/addresses-and-names-portfolio/addressbase-fundamentals/release-notes/addressbase-products-march-2025-epoch-117.md).

# AddressBase Products March 2025 – Epoch 117

## Record counts

| Product                | Full Supply Record Count | Change-Only Update Record Count |
| ---------------------- | ------------------------ | ------------------------------- |
| OS Open UPRN           | 41 052 332               | N/A                             |
| AddressBase            | 30 675 022               | 138 394                         |
| AddressBase Plus       | 38 286 245               | 721 346                         |
| AddressBase Premium    | See rows below           | See rows below                  |
| Street                 | 1 514 135                | 4 127                           |
| Street Descriptor      | 1 637 960                | 4 765                           |
| BLPU                   | 41 052 332               | 348 127                         |
| Classification         | 44 877 298               | 198 513                         |
| LPI                    | 46 285 106               | 149 761                         |
| Organisation           | 1 400 028                | 27 007                          |
| Delivery Point Address | 30 785 258               | 57 204                          |
| Application Cross Ref. | 198 910 566              | 717 312                         |
| Successor              | 0                        | 0                               |

{% hint style="info" %}

* The Full Supply record counts are based on a Managed Great Britain Set (MGBS). If you have ordered your national coverage via the online ordering system using a polygon outline, then your counts may differ.
* Please note that Change-Only Updates (COUs) are not available for the OS Open UPRN product.
  {% endhint %}

## Product supply comparison

There is a difference in product counts between taking a national Managed Great Britain Set (MGBS) and a national Area of Interest (AOI). This is because the two supplies use different selection criteria. The differences are shown in the following table, allowing for you to validate your data holdings once you have loaded the latest release of AddressBase data.

The national AOI refers to the pre-selection GB polygon from our download store. Therefore, if you have drawn your own AOI, the count will vary.

If you are unsure of your supply type, please check this with your OS Relationship Manager.

| Product                | MGBS Full Count | National AOI Full Count | Difference     |
| ---------------------- | --------------- | ----------------------- | -------------- |
| AddressBase            | 30 675 022      | 30 675 022              | 0              |
| AddressBase Plus       | 38 286 245      | 38 286 223              | 22             |
| AddressBase Premium    | See rows below  | See rows below          | See rows below |
| Street                 | 1 514 135       | 1 514 132               | 3              |
| Street Descriptor      | 1 637 960       | 1 637 957               | 3              |
| BLPU                   | 41 052 332      | 41 052 306              | 26             |
| Classification         | 44 877 298      | 44 877 272              | 26             |
| LPI                    | 46 285 106      | 46 285 079              | 27             |
| Organisation           | 1 400 028       | 1 400 026               | 2              |
| Delivery Point Address | 30 785 258      | 30 785 258              | 0              |
| Application Cross Ref. | 198 910 566     | 198 910 540             | 26             |
| Successor              | 0               | 0                       | 0              |

It is important that COUs are processed with Deletes first, then Inserts and Updates. This is to ensure that updates are applied in the correct order. Guidance on this can be found in the '[Working with COU data' page in the AddressBase Core Getting Started Guide](/os-downloads/products/addresses-and-names-portfolio/addressbase-core/addressbase-core-getting-started-guide/working-with-cou-data.md).

## Changed records

If you receive a Change-Only Update (COU) supply for your AddressBase product, you will receive Insert, Update and Delete records within the supplied file. The following tables detail the numbers of these records which can be expected in an **MGBS supply**, and also how many tiles are affected if you take your supply as Changed Chunks.

### AddressBase

| Change Type              | Count  |
| ------------------------ | ------ |
| Inserts                  | 32 301 |
| Updates                  | 96 676 |
| Deletes                  | 9 417  |
| COU Populated Tile Count | 5 412  |

### AddressBase Plus

| Change Type              | Count   |
| ------------------------ | ------- |
| Inserts                  | 47 638  |
| Updates                  | 659 891 |
| Deletes                  | 13 817  |
| COU Populated Tile Count | 7 297   |

### AddressBase Premium

| AddressBase Premium Table | Inserts | Updates | Deletes |
| ------------------------- | ------- | ------- | ------- |
| Street                    | 1 071   | 3 031   | 25      |
| Street Descriptor         | 1 114   | 3 616   | 35      |
| BLPU                      | 44 401  | 299 702 | 4 024   |
| Classification            | 68 269  | 102 102 | 28 142  |
| LPI                       | 59 085  | 85 866  | 4 810   |
| Organisation              | 5 710   | 8 051   | 13 246  |
| Delivery Point Address    | 33 073  | 14 982  | 9 149   |
| Application Cross Ref.    | 191 523 | 486 447 | 39 342  |

## Source data currency

The following information relates to the currency of the source data used in the creation of **Epoch 117**:

| Data Source                          | Date             |
| ------------------------------------ | ---------------- |
| Royal Mail PAF                       | 13 February 2025 |
| National Land and Property Gazetteer | 13 February 2025 |
| One Scotland Gazetteer               | 27 January 2025  |
| VOA Non-Domestic Rates               | 10 February 2025 |
| VOA Council Tax                      | 10 February 2025 |
| OS MasterMap Topography Layer        | 16 January 2025  |
| OS MasterMap Highways Network        | 06 February 2025 |
| Code-Point with Polygons             | 02 January 2025  |
| Boundary-Line                        | 02 October 2024  |

## Data issues

### AddressBase Plus issues

**Affected output formats: CSV and GML**

* There are **7 966** Unique Property Reference Numbers (UPRNs) which reference a Parent UPRN that cannot be found in the product. This is because the Parent UPRN is either provisional or historic and is not matched to the Royal Mail Postcode Address File (PAF) or Valuation Office Agency (VOA) record, meaning that it is not included in the AddressBase Plus product as per the existing background logic rules.
* There are **231** records with a sao\_start\_no or sao\_text that have no Parent UPRN in the product. This is because the Parent UPRN is a historical record which is included as part of the logic for record inclusion in the AddressBase Plus products.

## Improvements in Epoch 117

### Valuation Office Agency matching

The match rates for Council Tax and Non-Domestic Rates for Epoch 117 are detailed as follows based on Valuation Office Agency (VOA) records up to **10 February 2025**. The match rate is applicable to the AddressBase Premium product.

| Data Source        | Records Received | % Matched |
| ------------------ | ---------------- | --------- |
| Council Tax        | 27 247 539       | 99.9      |
| Non-Domestic Rates | 2 120 424        | 96.48     |

### Tertiary classifications

Work is being undertaken to improve the classifications of records within the AddressBase products. This work has resulted in 69 348 more tertiary classifications present in Epoch 117 compared to Epoch 116. Indeed, 88.6 % of these tertiary classification improvements are against residential codes.

## Next release

The next release of AddressBase products, Epoch **118**, is scheduled for **01 May 2025**.


---

# 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/os-downloads/products/addresses-and-names-portfolio/addressbase-fundamentals/release-notes/addressbase-products-march-2025-epoch-117.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.
