OS Places API

 

PLACES & NETWORKS

 

 

OS Places API

 

 

Our secure, scalable, and resilient address look-up web service, OS Places API lets you search the UK's most comprehensive online address database.

 

With OS Places API, managing customer data is a breeze. Lightning-quick postcode and address search means your records are accurate and customer deliveries should always get to the right front door.

 

For customer data managers, the address matching and cleansing tools in OS Places API let you build trust in your information. They make it simple to correct errors from misheard phone calls, for example, so you get fewer duplicate records.

When an incident happens, control room staff need to know which properties are closest. OS Places’ geosearch tool gives instant answers. This helps create the common operating picture that’s vital for the emergency services.

 

Plan Options

Free trial

Premium

Existing Data Licensees & Partner

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

 

 

 

Register
to start a free trial

Get started using OS APIs straight away without  needing to hold an existing OS data licence. Premium Service plans are for 12 months, paid in advance.

 

 

   Contact us
to activate Premium plans

Our Partners and Public Sector Mapping Agreement members with a GB licence for OS Data should select these OS API plans. Service plans are for 12 months.

 

 

Contact us
to activate these plans

 

Pricing

Trial

Premium 

  

2,000   Transactions

100,000 Transactions

500,000 Transactions

1,000,000 Transactions

5,000,000 Transactions

10,000,000 Transactions

 

 

 

 

 

 

Free - two months

£7,350

£34,650

£68,300

£215,500

£229,500
2,000 transactions / 60 days
100,000 transactions / year
500,000 transactions / year
1,000,000 transactions / year
5,000,000 transactions / year
10,000,000 transactions / year
You can license this data free to evaluate it for your internal business use or to develop products and services prior to commercialisation.
Prices effective from 01/07/2019.
 
Internal Business Use
Premium plans are designed for internal business use only.
 
Creating products or services
Choose our plans for existing data licensees to use our APIs in your own products and services, or to distribute it.
 
Public Sector Mapping Agreements
Members of Public Sector Mapping Agreements should use our plans for existing data licensees.
 

Trial

Existing GB Data Licensees

  

2,000   Transactions

100,000 Transactions

500,000 Transactions

1,000,000 Transactions

5,000,000 Transactions

10,000,000 Transactions

 

 

 

 

 

 

Free - two months

£1,100

£3,400

£5,900

£22,000

£36,000
2,000 transactions / 60 days
100,000 transactions / year
500,000 transactions / year
1,000,000 transactions / year
5,000,000 transactions / year
10,000,000 transactions / year
You can license this data free to evaluate it for your internal business use or to develop products and services prior to commercialisation. 
 

 
Internal business use
When using OS data in your own business, you need our Framework Contract (Direct Customers) together with a data contract. 
 
Partners - 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. 
 
Public Sector Mapping Agreements
Assumes user signed up to Royal Mail® Public Sector Licence (PSL), meaning user will not have to pay for data or Postcode Address File (PAF®) fees. 

Trial 

Partner

2,000   Transactions

Reseller

Free - 2 Months

Contact us
2,000 transactions / 2 months 
Unlimited / year
 
You can license this data free to evaluate it for your internal business use or to develop products and services prior to commercialisation.
A 12-month plan, paid quarterly in arrears with royalties and service charges combined - based on usage type. Learn more.
 
To use this data commercially in your own products and services, 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. 
 
 
 
 
 
 

 

Capture and Verification

 

Improve efficiency – use OS Places to verify the data you’re capturing against Ordnance Survey’s core AddressBase® Premium dataset.

 

Edit out-of-date (or partial) details of residential and commercial properties in your own databases and make it personal: add shareable URPNs to existing features, such as post-boxes or warehouses.

 

 

 

 

Matching & Cleansing

 

With OS Places, you’ll have instant, reliable search results to make deduping and cleansing address data easier for your business.

 

Improve efficiency, guarantee accuracy and reduce costs throughout. Use postcodes and UPRNs or text strings to identify and match your targets – get information about residential and commercial properties quickly and easily.

 

 

 

 

Geosearch

 

Make sure OS Places is driving your applications, and users will have access to some of the most sophisticated online GeoSearch services.

 

Let them draw their own bounding boxes or define a specific radius search area, and use the API to pull up all known address data within that location

 

 

Specification

Key Features

Availability

99.9% uptime (See Service Levels and Maintenance as defined in our Terms of Service)

Output formats

JSON and XML (Full technical documentation)

Data update frequency

Every six weeks

Geographical coverage

Address, geometry and UPRN for GB; address only for Northern Ireland, Isle of Man and Channel Islands
Free to trial

You may be a large business, looking for APIs to integrate with your own GIS. Perhaps you’re an independent developer who wants to create a new web or mobile app. Either way, you’re welcome to trial all three features of the OS Places API free of charge. All we ask is that you don’t go over 10,000 transactions (combined, across all three features).

Register to start a free trial.

Description

With this API, you’ll enable users to identify addresses accurately, quickly, and with reliable high levels of detail. OS Places API has the benefit of accessing historic data in the property’s lifecycle too, which should reduce ambiguity throughout. It opens up three essential, time and money-saving pieces of functionality:

 

  • Geosearch – enabling finds of addresses or reverse geocoding via radius search, or by drawing a boundary box. 

 

  • Matching & Cleansing – integrating with existing systems to enable faster, more accurate postcode look-ups and autocompletion on websites and Enterprise customer service systems.

 

  • Capture & Verification – checking address data, quickly and reliably, to enable deduping of entries in already populated databases and provide verified uniformity. 

Data sources

OS Places API derives data from our AddressBase Premium dataset – Great Britain’s most detailed view of addresses and their life cycles, including everything from planning to creation to change of use and demolition.

 

AddressBase itself contains local authority, Ordnance Survey and Royal Mail addresses, current and alternative addresses, provisional addresses (still in the planning stage) and historic information too, where it’s available. It also includes Objects Without Postal Addresses (OWPAs) and cross references to the OS MasterMap TOIDs, as well as:

 

  • Up to date cross references to our large-scale data, such as OS MasterMap Topography Layer and Integrated Transport Network Layer via the TOID – but also references to objects that don’t have postal addresses, as well as coordinates that have been verified via our surveyors.

 

  • Data from the Local Land and Property Gazetteer and One Scotland Gazetteer, which includes information captured under statutory obligation through the SNN process.

 

  • The Royal Mail’s data, providing a Postcode Address File (PAF) containing the UDPRN and the delivery point address record.

 

  • The Valuation Office Agency, which provides cross references to council tax and non-domestic rates data.

Useful to know

OS Places API won’t find general areas (such as ‘forest’), or perform bulk address matches in its off-the-shelf form. However, if bulk matching could be useful to you, please let us know.

 

The geosearch resources – find the nearest, find within a specific radius, and find within a bounding box – all need X and Y coordinates entered in BNG (Eastings and Northings). However, postcode searches can be performed using only the area and district integers. For example:

 

  • SO16 0AS is the full postcode of our head office in Southampton. But searches for Ordnance Survey at SO16 will return details showing that our address is on Adanac Drive.

 

OS Places is a RESTful API, returning queries in either XML or JSON. The ‘find’ tool enables rapid searches of AddressBase Premium to discern ambiguous addresses, whereas the ‘match’ tool is for more granular matching and cleansing of existing address databases. There’s no need for any database management of AddressBase Premium itself.

 

The OS Places API accesses details of addresses in Northern Ireland, but these have a few unique characteristics due to not being derived from Address Base Premium. Addresses within Northern Ireland will not have a UPRN or status, and coordinates will be ‘0.0’ due to falling outside of the British National Grid.

Documentation and resources

At the OS APIs developer hub you'll find comprehensive guides, documentation and code snippets to help you start working with OS Places API as quickly as possible.

 

​

​Our terms and conditions

 

 

 

 

Get more information

Statistics

API docs

Support

Manage your API keys and monitor your

usage in My Keys

 

Comprehensive guides and code snippets to

start building with OS Places API 

Ask us questions and find answers in

Developer Portal support