Skip to main content

Gazetteer Service - SOAP API

Validate or retrieve UK-based postal addresses.


Use this API to validate and retrieve UK-based postal addresses using the Gazetteer Service.  Also known as the Address Finder, it can validate and transform the address to the Postcode Address File (PAF) standard, as well as search for and return an address list based on your search criteria.

You can:

  • get a single search result based on the house number or name and its postcode
  • get multiple search results based on partial address inputs or wild card searches
  • do fuzzy searches based on the phonetics of words entered in lines of an address
  • do intelligent postcode parsing to validate the underlying structure
  • get the PAF address key for each delivery point

You cannot use this API to update anyone's address.

API status

This API is stable.


This API is a SOAP API. 

For more details, see Basic SOAP.


For a full list of interactions for this API, see the Gazetteer Service - EIS Part 4.

Last edited: 3 February 2021 5:33 pm