Supported Countries List API (International)

Build
Send
Response
Errors

This page contains the technical API information. Please read our Javascript integration documentation if you are looking to learn more about the service.

This API is used to power the international autocomplete capability of the Addressfinder widget. It can also be used to power your own custom autocomplete functionality, such as in a mobile or desktop app. If you want to call this API from a web browser, there are some special guidelines that you will need to follow.

Build the GET request URL

Use the form below to build your request URL from the available parameters. The URL string will be generated and can be sent to the API in order to provide insight into how the API works and the response it returns. Or, if you are using Postman for your investigation, development and testing, include the desired parameters and copy and paste the request URL below into Postman's GET request URL field.

Field Name	Value	Type	Description
key *		String	Your unique licence key (find on Portal credentials)
secret *		String	Your unique secret key (find on Portal credentials). Alternatively, you can pass your secret key into the Authorization header of the request as such: `Authorization: your-secret`. FAQ: Learn more about authenticating direct API calls in request headers
format *		String	The required format of the response.
	Options json `json` for a response in json format. xml `xml` for a response in xml format.
domain		String	Used to identify which of your services is calling the API for activity monitoring purposes. This domain needs to be registered in the portal. FAQ: learn more about the domain parameter

* Parameters marked with an asterisk are mandatory for this API call.

Request URL

https://api.addressfinder.io/api/country/v1/list

      
        /* Click the button above to see a real API response here */
        {
          ...
        }

Response Specification

The API response will contain a hash with an element named countries, which is an hash containing containing country data, keyed by ISO 3166-1 alpha-2 country code, each with the following fields:

Field Name	Type	Description	Example
`Countries`	Group	Hash containing containing country data	countries:{"AU":{"name":"Australia","source":"internal"}}
`name`	String	Country name	Canada
`source`	String	Can be either "internal" or "external" to signify the origin of the addresses
`success`	Boolean	Indicates if the request was successful or not.	true

Errors

Below are the possible errors that can be returned by the API.