In order to access address searching and verification functionality, the request has to be authenticated.

There are two ways to make an authenticated API request:

  1. The **Auth-Token **HTTP request header has to be passed with the GET request. For example:

    GET HTTP/1.1
    **Auth-Token: 55929877-683b-856c-d3b8-7047fcf0582a**

Ensure your token works before proceeding. For example, using cURL:

curl -XGET -k --header "Auth-Token: 55929877-683b-856c-d3b8-7047fcf0582a"
  1. Alternatively, the token (auth-token) can be passed as a query parameter in the URL endpoint. For example:

    GET<your auth-token value>&country=GBR HTTP/1.1



Address Validate API REST supports Cross Origin Resource Sharing (CORS). This is a specification developed by W3C that allows browsers to make cross-domain requests thus enabling client side integrations. When making a request, the browser will add an origin request header. The API will then respond with a CORS specific response header denoting the origin domains allowed to make requests to the API.

CORS Supported OS and Browsers:

  • iOS devices (all versions)
  • Safari, IE and Chrome
Address Validation REST

Get started