Skip to main content

List purchased numbers

GET 
/api/v2/numbers

Retrieve a list of DID numbers purchased by the authenticated user.

Important notes:

  • Returns only active numbers by default
  • Use show_all=true to include numbers pending document approval
  • Includes service information (SMS, etc.)
  • Shows current status of each number

When to use:

  • Displaying user's number inventory
  • Checking number status
  • Listing numbers for configuration
  • Dashboard display

Authentication:

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

Request​

Responses​

returns DIDs