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.

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.

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:

  • Find addresses outside the United Kingdom, Isle of Man, Jersey and Guernsey.

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

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

Last updated