get
https://data.veridion.com/locations/v0
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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 ofcountry,region, orcity.children: nested locations — regions under a country, cities under a region. City objects have onlynameandtype.
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.

