Manage Numbers with the Vonage CLI
You can use the Vonage CLI to perform the following operations:
Read the installation instructions to get started.
List your numbers
The vonage numbers command lists all the numbers owned by the account.
vonage numbers Fetching owned numbers [======================================] 1/1 100% There is 1 number Number Country Type Features Linked Application ID ----------- ------------------ --------- --------------- ----------------------------- 12012108145 🇺🇸 United States Mobile MMS, SMS, VOICE Not linked to any application
Search for new numbers
Use the vonage numbers search command to list numbers available for purchase.
vonage numbers search US ✅ Searching for numbers There is 1 number available for purchase in United States Number Type Features Monthly Cost Setup Cost ----------- ------ --------------- ------------ ---------- 16127779311 Mobile MMS, SMS, VOICE €0.90 €0.00 Use vonage numbers buy to purchase.
Rent a number
Use the vonage numbers buy command to rent an available number. You will be prompted to confirm the purchase.
vonage numbers buy US 16127779311 ✅ Searching for numbers Are you sure you want to purchase the number 16127779311 for €0.90? [y/n] y ✅ Purchasing number Number 16127779311 purchased Number: 16127779311 Country: 🇺🇸 United States Type: Mobile Features: MMS, SMS, VOICE Monthly Cost: €0.90 Setup Cost: €0.00 Linked Application ID: Not linked to any application Voice Callback: Not Set Voice Callback Value: Not Set Voice Status Callback: Not Set
Cancel a number
Use the vonage numbers cancel command to cancel an existing number on your account. You must specify the number you wish to cancel and you will be prompted to confirm cancellation before the number is removed from your account.
vonage numbers cancel US 16127779311 Searching for number to cancel [======================================] 1/1 100% Are you sure you want to cancel 16127779311? [y/n] y ✅ Cancelling number Number cancelled