List Your Numbers
This page shows you how to list the numbers that you own programmatically.
You can also view your numbers online, using the developer dashboard or from the command line, using the Nexmo CLI.
Replace the following variables in the sample code with your own values:
Key | Description |
---|---|
VONAGE_API_KEY |
Your Vonage API key (see it on your dashboard). |
VONAGE_API_SECRET |
Your Vonage API secret (also available on your dashboard). |
NUMBER_SEARCH_CRITERIA |
The filter criteria. For example, numbers containing 234 . |
NUMBER_SEARCH_PATTERN |
Where the NUMBER_SEARCH_CRITERIA should appear in the number:
|
Write the code
Add the following to list-numbers.sh
:
curl "https://rest.nexmo.com/account/numbers?api_key=$VONAGE_API_KEY&api_secret=$VONAGE_API_SECRET&pattern=$NUMBER_SEARCH_CRITERIA&search_pattern=$NUMBER_SEARCH_PATTERN"
Run your code
Save this file to your machine and run it:
sh list-numbers.sh
Prerequisites
npm install @vonage/server-sdk
Create a file named list.js
and add the following code:
const Vonage = require('@vonage/server-sdk')
const vonage = new Vonage(
{
apiKey: VONAGE_API_KEY,
apiSecret: VONAGE_API_SECRET
},
{
debug: true
}
)
Write the code
Add the following to list.js
:
vonage.number.get(
{
pattern: NUMBER_SEARCH_CRITERIA,
search_pattern: NUMBER_SEARCH_PATTERN
},
(err, res) => {
if (err) {
console.error(err)
} else {
console.log(`Here are ${res.numbers.length} of your ${res.count} matching numbers:`)
res.numbers.forEach((number) => {
console.log(`Tel: ${number.msisdn} Cost: ${number.type}`)
})
}
}
)
Run your code
Save this file to your machine and run it:
node list.js
Prerequisites
Add the following to `build.gradle`:
compile 'com.vonage:client:6.2.0'
Create a class named ListNumbers
and add the following code to the main
method:
VonageClient client = VonageClient.builder()
.apiKey(VONAGE_API_KEY)
.apiSecret(VONAGE_API_SECRET)
.build();
Write the code
Add the following to the main
method of the ListNumbers
class:
NumbersClient numbersClient = client.getNumbersClient();
ListNumbersResponse response = numbersClient.listNumbers(
new ListNumbersFilter(1, 10, NUMBER_SEARCH_CRITERIA, NUMBER_SEARCH_PATTERN)
);
for (OwnedNumber number : response.getNumbers()) {
System.out.println("Tel: " + number.getMsisdn());
System.out.println("Type: " + number.getType());
System.out.println("Country: " + number.getCountry());
}
Run your code
We can use the application
plugin for Gradle to simplify the running of our application.
Update your build.gradle
with the following:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''
Run the following gradle
command to execute your application, replacing com.vonage.quickstart.numbers
with the package containing ListNumbers
:
gradle run -Pmain=com.vonage.quickstart.numbers.ListNumbers
Prerequisites
Install-Package Vonage
Create a file named ListOwnedNumbers.cs
and add the following code:
using Vonage;
using Vonage.Numbers;
using Vonage.Request;
Add the following to ListOwnedNumbers.cs
:
var credentials = Credentials.FromApiKeyAndSecret(VONAGE_API_KEY, VONAGE_API_SECRET);
var client = new VonageClient(credentials);
Write the code
Add the following to ListOwnedNumbers.cs
:
var request = new NumberSearchRequest()
{
SearchPattern = NUMBER_SEARCH_PATTERN,
Pattern = NUMBER_SEARCH_CRITERIA
};
var response = client.NumbersClient.GetOwnedNumbers(request);
Prerequisites
composer require vonage/client
Create a file named list-owned.php
and add the following code:
$basic = new \Vonage\Client\Credentials\Basic(VONAGE_API_KEY, VONAGE_API_SECRET);
$client = new \Vonage\Client($basic);
Write the code
Add the following to list-owned.php
:
try {
$filter = new \Vonage\Numbers\Filter\OwnedNumbers();
$filter
->setPattern((int) NUMBER_SEARCH_CRITERIA)
->setSearchPattern((int) NUMBER_SEARCH_PATTERN)
;
$response = $client->numbers()->searchOwned($filter);
echo count($response). " of your numbers match:\n";
foreach($response as $number) {
echo "Tel: " . $number->getMsisdn() . " Type: " . $number->getType() . "\n";
}
} catch (\Exception $e) {
echo $e->getMessage();
}
Run your code
Save this file to your machine and run it:
php list-owned.php
Prerequisites
pip install vonage
Create a file named list.py
and add the following code:
import vonage
client = vonage.Client(key=VONAGE_API_KEY, secret=VONAGE_API_SECRET)
Write the code
Add the following to list.py
:
responseData = client.get_account_numbers(
{"pattern": NUMBER_SEARCH_CRITERIA, "search_pattern": NUMBER_SEARCH_PATTERN}
)
print(
f'Here are {len(responseData["numbers"])} of the {responseData["count"]} matching numbers in your account:'
)
for number in responseData["numbers"]:
print(f'Tel: {number["msisdn"]} Type: {number["type"]}')
Run your code
Save this file to your machine and run it:
python list.py
Prerequisites
gem install vonage
Create a file named list.rb
and add the following code:
client = Vonage::Client.new(
api_key: VONAGE_API_KEY,
api_secret: VONAGE_API_SECRET
)
Write the code
Add the following to list.rb
:
begin
response = client.numbers.list()
puts "Here are #{response.numbers.length} of your #{response.count} matching numbers:"
response.numbers.each do |number|
puts "Tel: #{number.msisdn} Type: #{number.type}"
end
rescue
puts "Error listing your owned numbers"
end
Run your code
Save this file to your machine and run it:
ruby list.rb