List cities
GET/api/v2/numbers/countries/:country_id/cities
Retrieve a list of cities within a country where DID numbers are available.
Important notes:
- For a country with
has_provinces_or_states, numbers_search_show narrows to one state by itsregion_idfrom numbers_countries_regions_index - Each city includes count of available DIDs
- Cities are returned with area codes
When to use:
- Building city selection for countries without states
- Checking DID availability by city
- Displaying available locations to users
cities[].id feeds numbers_countries_cities_dids_index and numbers_search_show (city_id).
Request
Responses
- 200
- 401
- 403
- 404
returns list of cities
returns unauthorized
returns forbidden
returns not found