LogoLogo
OS Docs HomeOS NGDOS APIsOS Download ProductsMore than MapsOS Data Hub
  • Introduction to OS APIs
  • Core Concepts
    • Getting started with an API project
    • Authentication
    • Error codes
    • Rate-limiting policy
    • OS API branding
    • Service level agreements
    • Service availability dashboard
  • Accessing OS APIs
    • OS Maps API
      • Layers and styles
      • Getting started
        • ESRI ArcGIS Online
        • ESRI ArcGIS Pro
        • ESRI ArcMap
        • Cadcorp SIS
        • MapInfo Pro
        • QGIS
      • Technical specification
        • ZXY
        • WMTS
      • Code examples
    • OS Vector Tile API
      • What data is available?
      • Getting started
        • ESRI ArcGIS Pro
        • Cadcorp SIS
        • QGIS
        • Create a web application using the OS Vector Tile API
      • Technical specification
        • Service Metadata
        • Stylesheet
        • Tile request
      • Code examples
      • Stylesheets
    • OS NGD API – Tiles
    • OS NGD API – Features
    • OS Features API
      • OS Product Archive
      • What data is available?
      • Getting started
        • ArcGIS Online
        • ArcGIS Pro
        • ArcMap
        • Cadcorp SIS
        • MapInfo Pro
        • QGIS
      • Technical specification
        • getCapabilities
        • describeFeatureType
        • getFeature
        • Filtering
        • Paging
        • Empty values
      • Code examples
    • OS Names API
      • Getting started with example queries using Node.js
      • Technical specification
        • Find
        • Nearest
      • Code list
      • Code examples
    • OS Linked Identifiers API
      • What data is available?
      • Getting started with implementing a look-up application
      • Technical specification
        • Identifier
        • Identifier Types
        • Feature Types
        • Product Version Information
      • Code examples
    • OS Places API
      • Getting started with example queries using Node.js
      • Technical specification
        • Find
        • Postcode
        • UPRN
        • Nearest
        • BBOX
        • Radius
        • Polygon
      • Datasets
      • Code lists
      • Code examples
    • OS Match & Cleanse API
      • End of Life Information
      • Getting started with an example match query using Node.js
      • Technical specification
      • Datasets
      • Code lists
    • OS Downloads API
      • Getting started
        • Automating OS OpenData downloads
        • Automating OS Premium data downloads
      • Technical specification
        • OpenData products
        • OpenData product details
        • Download an OpenData product
        • OpenData product image
        • Data packages
        • Data package ID
        • Data package version
        • Data package version ID
        • Download a data package
    • OAuth 2 API
      • Getting started
      • Technical specification
  • Additional resources
    • OS API Wrappers
      • JavaScript
      • Python
      • R
  • Extra Links
    • Accessibility
    • Contact us
    • PSGA Product Summary
    • Terms and conditions
Powered by GitBook
On this page

Was this helpful?

  1. Accessing OS APIs

OS Places API

PreviousProduct Version InformationNextGetting started with example queries using Node.js

Last updated 2 months ago

Was this helpful?

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.

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 -

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.

  • Format: GeoJSON, XML

  • Data Source: and

  • Coverage: Great Britain

  • Update: Daily

  • OS Data Hub plan: Premium Plan, Public Sector Plan

Things to remember for OS Places API

You can:

  • Find a specific address accurately using a full or partial address, a postcode or a UPRN.

  • 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.

You can't:

  • Locate general areas such as cities, forests or beaches.

  • Carry out bulk queries (transactions are subject to API throttling).

AddressBase Premium
AddressBase Premium
AddressBase Premium Islands
Page cover image