OS Match & Cleanse API

The OS Match & Cleanse API provides a detailed view of an address and its life cycle. 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® 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.

OS Match & Cleanse API: map with an address search input and result overlain.

Things to remember for OS Match & Cleanse API

You can:

  • Correct or update UK addresses

  • Validate addresses against authoritative data

  • Match specific addresses accurately

  • Find addresses from partial information

  • Cleanse partial or incorrect addresses

  • Dedupe addresses in your records

  • Obtain the UPRN for matched addresses

  • Cross-reference other datasets using the Unique Property Reference Number (UPRN) and Topographic Identifier (TOID)

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

  • Retrieve all the detailed attribution from OS data.

  • Access OS Match & Cleanse API on a PSGA Member Plan.

Last updated