OS Places

OS Places is the UK's most comprehensive online address database. Find addresses instantly and be confident you're getting the most up-to-date information. Free trial ›

Image

Free trial

It's free to evaluate OS APIs for your internal business use or to develop products and services before commercialisation.

Register to start a free trial >

Buy a Premium plan

View our service plans and find out more about OS Places API.

Choose your plan >

PSMA member or Partner?

Activate your plan by getting in touch with us if you belong to the Public Sector Mapping Agreement or you're an OS Partner.

Contact us to activate your plan >

Feature 1

Cloud hosted

OS Places is always there for you. We guarantee 99.9% uptime. By signing up for it, you and your customers will always get results – and your IT team won’t have to manage the database.

Feature 1

AddressBase Premium inside

Our flagship address data product powers OS Places. It’s the most comprehensive address database in Great Britain, with over 41 million records. As well as residential and business addresses, these include village halls and properties not yet built.

Feature 1

Only pay for what you use

Our flexible pricing plans let you take advantage of tiered discounts based on usage. This helps you stretch your budget further. You can get started with our 60-day free trial.

Specifications

Key featuresWhat this product offers
Availability

99.9% uptime (see the OS API Framework Agreement)

Output formats

JSON and XML

Data update frequency

Every six weeks

Geographical coverage

Great Britain, Northern Ireland, Isle of Man and the Channel Islands

OS Places support ›

FAQs

How do I get access to the OS Places API?

OS Places is available to commercial customers who license AddressBase Premium, or OS partners who have signed up to a Defined Use Contract that includes AddressBase Premium.

Public sector customers just need to pay the usage fees for OS Places. It's not in the PSMA or OSMA, but they both include AddressBase Premium. You have to be licensed for it when using OS Places.

You'll need to sign up to the OS API Framework Agreement.

You can get started with our 60-day free trial.

How do I use the find resource?

The find resource is a service request based on either a full or partial address, intended to be a more ambiguous search function than the match resource. You can append a range of parameters to its URL.

How do I use the match resource?

The match resource is more accurate than the find resource, but is stricter on which addresses are matched. Like the find resource, it uses a free text search based on the query parameter. Both the DPA and LPI datasets can be searched. You can append a range of parameters to its URL.

To use the match resource effectively, a relatively complete address is required – searching for only the first line of an address will not be adequate to get results from the service and the search query is too ambiguous. Such searches are better suited for the find resource.

How do I use the Postcode resource?

The postcode resource returns addresses based on a postcode. The queried postcode can be a partial postcode consisting of just the area and district, or the area, district and sector, or a full postcode consisting of the area, district, sector and unit. You can append a range of parameters to its URL.

Is there a maximum number of results for my query?

Each request will return up to 100 results.

See all FAQs for OS Places ›

Licences

OS Places is available under the following Licences:

Explore our data

You’re welcome to try out this data for free under our Data Exploration Licence.

Internal business use

When using OS data in your own business, you need our Framework Contract (Direct Customers) together with a data contract.

Creating products or services

To use this data commercially in your own products and services, or to distribute it, you will need to sign up to our Framework Contract (Partners) and a relevant defined use contract. This will vary depending on what you’re going to do with the data.

Collective mapping agreements

These products are available to members of public sector organisations under the following agreements:

Find out more in our Public sector licensing guide ›

This product is available under the:

  • Media Licence. We encourage the use of OS maps in the media – TV, films, print and online. Sign up free to give your consumers valuable context via an authoritative map.
  • Publishing licence. This is suitable for one-off publishing of maps in publications, on merchandising and websites.
View all licences ›

Case studies