Search locations by prefix
GET/api/v2/numbers/countries/:country_id/locations
Search for locations (cities) that have DID numbers starting with a specific prefix.
Important notes:
- Useful for finding locations with specific area codes
- Prefix can be partial number (e.g., "212" for NYC area code)
- Returns combined location information (country, state, city)
When to use:
- Implementing "vanity number" search by prefix
- Finding locations with specific area codes
- Reverse lookup of number to location
Authentication:
- Requires Bearer token in Authorization header:
Authorization: Bearer <token>
Request
Responses
- 200
- 401
- 403
- 404
returns list of locations
returns unauthorized
returns forbidden
returns not found