# OS Places API

OS Places API provides direct access to rich address data for geocoding, postcode searching, form-filling and much more. Find addresses within the United Kingdom, Jersey, Guernsey and Isle of Man instantly online and be confident you're getting the most up-to-date information.

The OS Places API presents a detailed view of an address and its life cycle. It contains all the records of AddressBase Premium and AddressBase Premium – Islands, providing all the information relating to an address or property from creation to retirement.

OS Places API contains local authority, Ordnance Survey and Royal Mail addresses, current addresses, and alternatives for current addresses, provisional addresses (such as planning developments) and historic information, plus OWPAs and cross-references to the OS MasterMap TOIDs.

OS Places API includes addresses located within the United Kingdom, Jersey, Guernsey and the Isle of Man. For address records in Jersey and Guernsey the coordinates will be ‘0.0’ as they fall outside of the British National Grid. This means they are not compatible with the GeoSearch operations.

{% tabs %}
{% tab title="Features" %}
**Accurate address lookup**

Supports geocoding and reverse geocoding of UK addresses.

**Multiple search options**

Allows searching by different address information such as postcode, full or partial address or UPRN.

**Authoritative address dataset**

Uses OS's comprehensive and authoritative addressing data – [AddressBase Premium](https://docs.os.uk/os-downloads/products/addresses-and-names-portfolio/addressbase-premium) 
{% endtab %}

{% tab title="Benefits" %}
**Reduce address input errors**

Improve operational efficiency and data accuracy by capturing accurate addresses.

**Enhance user experience**

Enhance the user experience of your applications by speeding up address entry with autocomplete functionality.

**Up-to-date address data**

Providers accurate and continuously updated address data.
{% endtab %}

{% tab title="Summary" %}

* **Format:** GeoJSON, XML
* **Data Source**: [AddressBase Premium](https://docs.os.uk/os-downloads/products/addresses-and-names-portfolio/addressbase-premium) and [AddressBase Premium Islands](https://docs.os.uk/os-downloads/products/addresses-and-names-portfolio/addressbase-premium-islands)
* **Coverage:** United Kingdom, Jersey, Guernsey and the Isle of Man
* **Update:** Daily
  {% endtab %}
  {% endtabs %}

## **Things to remember for OS Places API**

{% hint style="success" %}
You can:

* Find a specific address accurately using a full or partial address, a postcode or a UPRN (Unique Property Reference Number)
* Find addresses closest to a given point or all addresses within a defined area, bounding box or circle
* Geocode (add the location element) and reverse-geocode an addresses
* Obtain the UPRN for addresses
* Search both Royal Mail and Local Authority address datasets
* Find addresses in the United Kingdom, Isle of Man, Jersey and Guernsey
* Verify your address records against authoritative data
  {% endhint %}

{% hint style="warning" %}
You can't:

* Locate general areas such as cities, forests or beaches
* Carry out bulk queries (transactions are subject to API throttling)
  {% endhint %}

## What's next?

<table data-view="cards"><thead><tr><th></th><th></th><th><select><option value="zQyj2iwc0ucW" label="Labs.os.uk" color="blue"></option></select></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Getting started with example queries using Node.js</strong></td><td>Example queries that you can adapt and use with OS Places API.</td><td></td><td><a href="os-places-api/getting-started-with-example-queries-using-node.js">getting-started-with-example-queries-using-node.js</a></td></tr><tr><td><strong>Technical specification</strong></td><td>This technical specification explains the content of the OS Places API and the methods you can use to call it.</td><td></td><td><a href="os-places-api/technical-specification">technical-specification</a></td></tr><tr><td><strong>Code examples</strong></td><td>Code examples you can use to display a map using the OS Places API.</td><td><span data-option="zQyj2iwc0ucW">Labs.os.uk</span></td><td><a href="https://labs.os.uk/public/os-data-hub-examples/os-places-api/capture-and-verify-example-find#maplibre-gl-js">https://labs.os.uk/public/os-data-hub-examples/os-places-api/capture-and-verify-example-find#maplibre-gl-js</a></td></tr></tbody></table>


---

# Agent Instructions: 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:

```
GET https://docs.os.uk/os-apis/accessing-os-apis/os-places-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.