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.

  • Addressing and location
  • API
  • Public Sector Plan
  • Premium Plan
  • Energy & Infrastructure Plan

This product is updated daily

Representation of data provided
Representation of data provided
© Crown copyright and database rights. Ordnance Survey 2024

What OS Places API provides you with

Accurate geocoding

Perform accurate geocoding and reverse geocoding with our secure, scalable, and resilient address look-up web service.

Complete addresses

Search by postcode, UPRN, full or partial address and ensure you get the right address first time. Keep your records accurate to provide effective citizen services.

Instant answers

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

Capture and verify data

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

GeoSearch services

Make sure OS Places is driving your applications, and users will have access to some of the most sophisticated online GeoSearch services, such as drawing their own bounding boxes or defining a specific radius search area.

7 Endpoints

OS Places API has 7 endpoints, each giving you a different way to find addresses.

OS Places API

Technical information

© Crown copyright and database rights. Ordnance Survey 2024


Use cases

With OS Places API you can:

  • Find a specific address accurately in the United Kingdom, Isle of Man, Jersey and Guernsey
  • Find all addresses within a defined area
  • Obtain the UPRN for addresses
  • Geocode addresses (add the location element) and reverse geocode an address from its location
  • Search both Royal Mail and Local Authority address datasets.
  • API
Data theme
  • Address
Data structure
Vector - Points
Great Britain
1:1250 to 1:10,000
  • JSON and XML
OS Data Hub plan
  • Public Sector Plan
  • Premium Plan
  • Energy & Infrastructure Plan

Documents and Support

Getting started guides

  • OS Places API - Getting started guide
    The getting started guide provides instructions for using the product in different software applications. Users with limited technical knowledge will be able to follow this guide.

Technical specification

Supporting documents

  • OS Places API - Overview
    The overview introduces the product and gives context for all users. It highlights key features, provides examples of potential uses for the product and lists details like file sizes, supply formats, etc.

Additional information

Edit details

Edit out-of-date (or partial) details of residential and commercial properties in your own databases and add unique references to your properties, via the UPRN, for enhanced data management.

With OS Places API you can add intuitive address search (geocoding) capabilities to your applications. Let a user search a full or partial address, a postcode or a UPRN and find the complete address including its location.

General area requirements

OS Places API won’t find general areas (such as ‘forest’). For this requirement we recommend you use OS Names API.

OS Places API

Get this product

What you get

Key features
  • Accurate geocoding
  • Complete addresses
  • Instant answers
  • Capture and verify data
  • GeoSearch services
  • 7 Endpoints
Addressing and location
  • API
Data structure
Vector - Points
Update frequency

How to access


Ordnance Survey's commercial network of Partners can help you with bespoke location solutions, derived from OS data

Ranging from global giants to single entrepreneurs, our Partners all use our location data to create innovative products and services. Their expertise ensures customers can benefit from using our data for a range of services. Find a partner for addressing and location mapping requirements.

Find a Partner


Ready to get started with our data and APIs?

Choose your plan and create your account. Take the next step by signing up to the OS Data Hub and create your first project today.

Sign up to the OS Data Hub

Our Partners

Download Premium data from the OS Data Hub

If you're an OS Licensed Partner you can use the OS Data Hub to access OS data products and manage your account all in one place.

Read guidance for Partners

Government and public sector

OS Data Hub for PSGA members

If your organisation is a member of the Public Sector Geospatial Agreement, access the OS Data Hub to access our products.

Go to the OS Data Hub

Utilities and Telecoms

OS Connect support

Our Ordnance Survey Account Managers have specialist knowledge of projects for utilities and telecoms customers and should be your first point of contact for product enquiries.

Find OS Connect support

Get help

Further support

For further help about how our data can transform your organisation, contact us today

Contact us