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
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
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.
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.
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
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
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
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
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