Skip to main content

List numbers by city

GET 
/api/v2/numbers/countries/:country_id/cities/:city_id/dids

Retrieve paginated list of available DID numbers in a specific city.

Important notes:

  • For countries without regions (UK, Netherlands, etc.)
  • Results are paginated (default 25 per page)
  • Includes full pricing and feature details for each number
  • Use for countries where regions are not applicable

When to use:

  • Displaying available numbers after city selection
  • Browsing DID inventory by location
  • Non-US/Canada purchase flows

Authentication:

  • Requires Bearer token in Authorization header: Authorization: Bearer <token>

Request​

Responses​

returns list of available dids