> For the complete documentation index, see [llms.txt](https://docs.os.uk/os-apis/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-apis/accessing-os-apis/os-vector-tile-api/what-data-is-available.md).

# What data is available?

A guide outlining the data available through OS Vector Tile API.

Using OS Vector Tile API you can connect to different layers for different use cases, including a detailed basemap and several data overlays.

The map features don’t contain the complete list of attribution from the full data products. We have selected attribution that is useful for visualisation. The inclusion of unique IDs (where available) allow you to cross reference with the full product, for example, with [OS Features API.](/os-apis/accessing-os-apis/os-features-api.md)

## Basemap

This is a detailed OS basemap made from [OS Open Zoomstack](https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-open-zoomstack) and [OS MasterMap Topography Layer](https://docs.os.uk/os-downloads/products/maps-and-imagery-portfolio/os-mastermap-topography-layer).

The OS MasterMap Topography Layer building features have a property called `RelHMax` (height from the ground to the top of the building) which you can use to extrude and create 3D buildings.

## Data overlays

The following table details the datasets that can be used as overlays to the basemap to add additional information:

{% hint style="warning" %}

### Associated datasets reached / reaching their End of Life (withdrawal) date

The following associated datasets have reached their End of Life and have been removed from the API:

* The OS MasterMap Water Network Layer product (also referred to as OS MasterMap Networks – Water Layer) became End of Life on 31 March 2026 and was removed from the Vector Tile API. Further information on the withdrawal of this product is available on the [OS MasterMap Water Network Layer End of Life Information page](https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-documentation/os-mastermap-water-network-layer/os-mastermap-water-network-layer-end-of-life-information).
* The OS Detailed Path Network product became End of Life on 30 September 2026. As of this date, access to the product was removed from the OS Vector Tile API. Further information on the withdrawal of this product is available on the [OS Detailed Path Network End of Life Information page](https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-documentation/os-detailed-path-network/os-detailed-path-network-end-of-life-information).

The following associated dataset is reaching its End of Life date soon:

* The OS MasterMap Greenspace Layer product will become End of Life on 31 March 2027. As of this date, access to the product will be removed from the OS Vector Tile API. Further information on the withdrawal of this product is available on the [End of Life Notice – OS MasterMap Greenspace Layer page](https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-notices/end-of-life-notice-os-mastermap-greenspace-layer).
  {% endhint %}

<table data-full-width="false"><thead><tr><th width="140">Overlay</th><th width="147">Layer Name</th><th width="327">Description</th><th>Data Plan</th></tr></thead><tbody><tr><td><a href="https://docs.os.uk/os-downloads/products/areas-and-zones-portfolio/boundary-line">Boundaries</a></td><td><code>boundaries</code></td><td>This is a polygon layer made from Boundary-Line which can be used for identifying boundaries (for example, Counties, Districts and Parishes) and creating choropleth map overlays.</td><td>OS OpenData</td></tr><tr><td><a href="https://docs.os.uk/os-downloads/products/land-and-terrain-portfolio/os-mastermap-greenspace-layer">Greenspace</a></td><td><code>greenspace</code></td><td>This is a polygon layer made from OS MasterMap Greenspace Layer – Britain’s most comprehensive dataset of urban greenspaces.<br><br><strong>OS MasterMap Greenspace Layer will become End of Life on 31 March 2027. As of this date, this product will be removed from the OS Vector Tile API.</strong></td><td>Premium Data</td></tr><tr><td><a href="https://docs.os.uk/os-downloads/products/land-and-terrain-portfolio/os-mastermap-sites-layer">Sites</a></td><td><code>sites</code></td><td>This is a polygon layer made from OS MasterMap Sites Layer. Contains the site extents for key sites such as schools, hospitals and train stations and their main access points.</td><td>Premium Data</td></tr><tr><td><a href="https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-documentation/os-mastermap-water-network-layer">Water (withdrawn)</a></td><td><code>water</code></td><td>This is a line layer made from OS MasterMap Water Network Layer. Contains detailed centre lines following the curve of the waterways precisely, including rivers, streams and canals.<br><br><strong>OS MasterMap Water Network Layer reached its End of Life on 31 March 2026 and was removed from the OS Vector Tile API.</strong></td><td><p>N / A</p><p><br></p></td></tr><tr><td><a href="https://docs.os.uk/os-downloads/products/transport-network-portfolio/os-mastermap-highways-network-fundamentals">Highways</a></td><td><code>highways</code></td><td>This is a line layer made from OS MasterMap Highways Network. Contains detailed centre lines for roads, paths and ferry routes and includes the links that connect them.</td><td>Premium Data</td></tr><tr><td><a href="https://docs.os.uk/os-downloads/resources/product-resources/end-of-life-product-documentation/os-detailed-path-network">Paths (withdrawn)</a></td><td><code>paths</code></td><td><p>This is a line layer made from OS Detailed Path Network – a connected path network covering Britain’s National Parks.</p><p><br><strong>OS Detailed Path Network reached its End of Life on 30 September 2026 and was removed from the OS Vector Tile API.</strong></p></td><td>N/A</td></tr></tbody></table>

{% hint style="info" %}

## Thinking of migrating from OS MasterMap products to the OS NGD?

Like-for-like migration guidance is available on our [**More than Maps site**](https://docs.os.uk/more-than-maps/os-ngd-migration) to help customers of longstanding OS MasterMap products nearing their End of Life dates to smoothly transition to the OS National Geographic Database (OS NGD).
{% endhint %}

## Tile Matrix Set

### EPSG:3857 tile matrix set

The table below shows the resolution (meters per pixel) and scale of the zoom levels within the EPSG:3857 tile matrix set.

The zoom levels start at 6 to fit in with the industry standard initial zoom layer. This improves the interoperability of this tile matrix set with third party tools and applications.

<table><thead><tr><th width="169">Zoom Level</th><th>Resolution</th><th>Scale</th><th>Open or Premium</th></tr></thead><tbody><tr><td><strong>6</strong></td><td>1222.992452562495</td><td>1:4,622,324.43</td><td>Open data</td></tr><tr><td><strong>7</strong></td><td>611.496226281245</td><td>1:2,311,162.22</td><td>Open data</td></tr><tr><td><strong>8</strong></td><td>305.74811314069</td><td>1:1,155,581.11</td><td>Open data</td></tr><tr><td><strong>9</strong></td><td>152.874056570279</td><td>1:577,790.55</td><td>Open data</td></tr><tr><td><strong>10</strong></td><td>76.4370282852055</td><td>1:288,895.28</td><td>Open data</td></tr><tr><td><strong>11</strong></td><td>38.2185141425366</td><td>1:144,447.64</td><td>Open data</td></tr><tr><td><strong>12</strong></td><td>19.1092570712683</td><td>1:72,223.82</td><td>Open data</td></tr><tr><td><strong>13</strong></td><td>9.55462853563415</td><td>1:36,111.91</td><td>Open data</td></tr><tr><td><strong>14</strong></td><td>4.777314267817075</td><td>1:18,055.95</td><td>Open data</td></tr><tr><td><strong>15</strong></td><td>2.388657133974685</td><td>1:9,027.98</td><td>Open data</td></tr><tr><td><strong>16</strong></td><td>1.19432856698734</td><td>1:4,513.99</td><td>Premium data</td></tr><tr><td><strong>17</strong></td><td>0.597164283427525</td><td>1:2,256.99</td><td>Premium data</td></tr><tr><td><strong>18</strong></td><td>0.2985821417799085</td><td>1:1,128.50</td><td>Premium data</td></tr><tr><td><strong>19</strong></td><td>0.1492910708238085</td><td>1:564.25</td><td>Premium data</td></tr></tbody></table>

### EPSG:27700 tile matrix set

The table below shows the resolution (meters per pixel) and scale of the zoom levels within the EPSG:27700 tile matrix set.

The zoom levels start at 0 rather than at 6 used for the EPSG:3857 tile matrix set, but the range of resolutions and scales is comparable. EPSG:27700 zoom level 0 is similar to EPSG:3857 zoom level 6.

<table><thead><tr><th width="179">Zoom Level</th><th>Resolution</th><th>Scale</th><th>Open or Premium</th></tr></thead><tbody><tr><td><strong>0</strong></td><td>3584</td><td>1:13,545,799.68</td><td>Open data</td></tr><tr><td><strong>1</strong></td><td>1792</td><td>1:6,772,899.84</td><td>Open data</td></tr><tr><td><strong>2</strong></td><td>896</td><td>1:3,386,449.92</td><td>Open data</td></tr><tr><td><strong>3</strong></td><td>448</td><td>1:1,693,224.96</td><td>Open data</td></tr><tr><td><strong>4</strong></td><td>224</td><td>1:846,612.48</td><td>Open data</td></tr><tr><td><strong>5</strong></td><td>112</td><td>1:423,306.24</td><td>Open data</td></tr><tr><td><strong>6</strong></td><td>56</td><td>1:211,653.12</td><td>Open data</td></tr><tr><td><strong>7</strong></td><td>28</td><td>1:105,826.56</td><td>Open data</td></tr><tr><td><strong>8</strong></td><td>14</td><td>1:52,913.28</td><td>Open data</td></tr><tr><td><strong>9</strong></td><td>7</td><td>1:26,456.64</td><td>Open data</td></tr><tr><td><strong>10</strong></td><td>3.5</td><td>1:13,228.32</td><td>Open data</td></tr><tr><td><strong>11</strong></td><td>1.75</td><td>1:6,614.16</td><td>Open data</td></tr><tr><td><strong>12</strong></td><td>0.875</td><td>1:3,307.08</td><td>Premium data</td></tr><tr><td><strong>13</strong></td><td>0.4375</td><td>1:1,653.54</td><td>Premium data</td></tr><tr><td><strong>14</strong></td><td>0.21875</td><td>1:826.77</td><td>Premium data</td></tr><tr><td><strong>15</strong></td><td>0.109375</td><td>1:413.39</td><td>Premium data</td></tr></tbody></table>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.os.uk/os-apis/accessing-os-apis/os-vector-tile-api/what-data-is-available.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.