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 ›
Free trialIt'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 planView 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 >
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.
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.
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.
|Key features||What this product offers|
99.9% uptime (see the OS API Framework Agreement)
JSON and XML
|Data update frequency|
Every six weeks
Great Britain, Northern Ireland, Isle of Man and the Channel Islands
How do I get access to the OS Places API?
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.
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: