# OS Places API

With OS Places API you have direct access to rich address data for geocoding, postcode searching, form-filling and much more. Find UK addresses instantly online and be confident you're getting the most up-to-date information.

The OS Places API provides a detailed view of an address and its life cycle. It contains all the records of AddressBase Premium and AddressBase Premium – Islands, that is it provides 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:** Great Britain
* **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>