Loqate services can be accessed securely over HTTPS - we do not support API connections that use HTTP or a TLS protocol below version 1.2.

Base URL

Each API has a base URL on which the required data endpoint can be appended, such as json3.ws or xmle.ws. For SOAP, use wsdlnew.ws.
Customers located in China should use services.postcodeanywhere.co.uk as part of the base URL, rather than api.addressy.com.

Authentication

APIs require authentication in the form of a key, which can be created by adding a service in your account. Each key has its own security settings (URL & IP restriction, usage limits), and as many keys as necessary can be set up with these restrictions. See the Creating API Keys page for more information. A key must be passed to the API as a parameter in order for the request to authenticate, otherwise an error will be returned.

Common errors

Each API has specific errors that may be returned, as well as a common set of errors relating to either account or key settings. See the Common errors page for details.