Skip to main content

List my 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

dids[].id feeds update_purchased_number and release_number (id, id_in[]). dids[].number feeds release_number (did_numbers[]). dids[].id feeds list_number_destinations, add_number_destination, update_number_destination and remove_number_destination (purchase_id, which takes the number too). dids[].identity_id feeds list_identities and update_purchased_number (ids, identity_id). See also: list_number_purchases.

Request​

Responses​

returns DIDs