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 Match & Cleanse API

PreviousCode listsNextEnd of Life Information

Last updated 3 months ago

Was this helpful?

The OS Match & Cleanse API will become End of Life on 31 March 2026 and withdrawn. After this date, the API will be removed from all existing API projects and will no longer be accessible. For further information, please visit End of Life Information.

The OS Match & Cleanse API provides a detailed view of an address and its lifecycle. It contains all the records of AddressBase Premium and AddressBase Premium – Islands and so provides all the information relating to an address or property from creation to retirement.

It contains local authority, Ordnance Survey and Royal Mail addresses, current addresses, multilingual and alternatives for current addresses, provisional addresses (such as planning developments) and historic information, plus cross references to the OS MasterMap Topographic Identifiers (TOIDs) and Unique Property Reference Numbers (UPRNs).

OS Match & Cleanse API contains 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.

Each address returned is given a match score so you can be confident of the matched address based on its likeness to the input text string. Scores are provided from 0 to 1.0, where 1.0 represents an EXACT match. You can control the precision of the match score in the event of results sharing a close match score.

Things to remember for OS Match & Cleanse API

You can:

  • Match specific addresses accurately.

  • Cleanse partial or incorrect addresses.

  • Obtain the UPRN for matched addresses.

  • Search both Royal Mail and Local Authority address datasets.

  • Geocode addresses (add the location element).

  • Match addresses in the United Kingdom, Isle of Man, Jersey and Guernsey.

You can't:

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

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

  • Access the OS Match & Cleanse API under the Public Sector Geospatial Agreement (PSGA) on the .

Public Sector Plan
Page cover image