Make a test call

There are many different ways to make API requests. This section covers two ways you can send a test request to the API

Follow the instructions below to send requests to the API from this page:

  1. Go to API specification and click Authorize.
  2. Enter your token into the Value fields.
  3. Click the GET /search block, so that it expands.
  4. Click the Try it out button in the upper-right corner.
  5. Enter Query in the query field.
  6. Enter Country in the Country field using the 3 digit ISO code.
  7. (Optional) Enter Location using the geographic coordinates of the location where the user is searching for an address, in the format “{latitude},{longitude}” (USA ONLY).
  8. (Optional) Under Take which is the maximum number of results to be returned. The default value is 7.
  9. (Optional) Under Dataset which is the name of the dataset to be used for the country where the address is located.
  10. Click the Execute button to send the request to the API.
  11. View the response returned by the API under Responses. Note that your request was successful only if the API returned an HTTP status code of 200 - Success. Check out Response status codes to find out more about scenarios where the API returns errors.

Postman is a free, easy-to-use third-party application that you can use to send API calls.

Follow these instructions to send requests to the API via Postman:

  1. Download and install the free Postman app.
  2. Download the relevant file.
  3. Open the Postman app and click the Import button in the upper-left corner. !
  4. Import the file you've downloaded.
  5. Go to the Collections tab on the left-hand side panel and click the API request you want to test.
  6. Go to the Headers tab.
  7. Replace the {{Auth-Token}} value with your token.
  8. Go to the Body tab.
  9. (Optional) Replace the address value with an address of your choice. Note that the address value must be enclosed in quotation marks, e.g. "125 summer St". Alternatively, you can skip this step and use the preset values.
  10. Click the Send button to submit the API request.
  11. View the response returned by the API. Note that your request was successful only if the API returned an HTTP status code of 200 - Success. Check out Response status codes to find out more about scenarios where the API returns errors.
Global Intuitive

Get started