Managing Numbers

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