Retrieving Veridion locations

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

The Veridion locations endpoint returns the hierarchy of geographic locations Veridion uses: countries, their regions, and their cities. Use it to get the exact location names to pass to the company_location filter, so your inputs match how locations are stored and your results stay accurate.

Why use it

  • Consistency — a standardized way to name locations, avoiding mismatched geographic input.
  • Accuracy — inputs that match Veridion's stored values match more reliably.
  • Ease of use — the hierarchy makes it straightforward to find a specific region or city within a large country, with many nested subdivisions.

Successful Responses

200 OK returns a JSON array of country objects. Each location object has:

  • name: the location name.
  • type: one of country, region, or city.
  • children: nested locations — regions under a country, cities under a region. City objects have only name and type.

Using the values

Pass the names into a company_location location object, where country is required and region / city are optional:

{ "country": "United States", "region": "New York", "city": "New York" }

Error responses

Any error response follows a specific structure. Please see the Error response format section for more details.

Headers
string
required

Your individual OAuth Bearer token (e.g. Authorization: Bearer <your_access_token>).

Response

Language
LoadingLoading…
Response
Choose an example:
application/json