Numbers API

nexmo · Company

Company No Auth Free & Open API

The Numbers API enables you to manage your existing numbers and buy new virtual numbers for use with the Vonage APIs. Further information is here:

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET List the numbers you own

Retrieve all the inbound numbers associated with your Vonage account.

https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/account/numbers?size=10&index=1&country=US&pattern=example&application_id=example&search_pattern=0&has_application=true

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/account/numbers?size=10&index=1&country=US&pattern=example&application_id=example&search_pattern=0&has_application=true"

import requests
params = {
    "size": "10",
    "index": "1",
    "country": "US",
    "pattern": "example",
    "application_id": "example",
    "search_pattern": "0",
    "has_application": "true"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/account/numbers",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/account/numbers');
url.searchParams.set('size', '10');
url.searchParams.set('index', '1');
url.searchParams.set('country', 'US');
url.searchParams.set('pattern', 'example');
url.searchParams.set('application_id', 'example');
url.searchParams.set('search_pattern', '0');
url.searchParams.set('has_application', 'true');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/account/numbers")
	q := baseURL.Query()
	q.Set("size", "10")
	q.Set("index", "1")
	q.Set("country", "US")
	q.Set("pattern", "example")
	q.Set("application_id", "example")
	q.Set("search_pattern", "0")
	q.Set("has_application", "true")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/account/numbers")
uri.query = URI.encode_www_form({
  "size" => "10",
  "index" => "1",
  "country" => "US",
  "pattern" => "example",
  "application_id" => "example",
  "search_pattern" => "0",
  "has_application" => "true"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/account/numbers?" . http_build_query([
    "size" => "10",
    "index" => "1",
    "country" => "US",
    "pattern" => "example",
    "application_id" => "example",
    "search_pattern" => "0",
    "has_application" => "true"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Search available numbers

Retrieve inbound numbers that are available for the specified country.

https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/search?size=10&type=landline&index=1&country=US&pattern=example&features=SMS&search_pattern=0

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/search?size=10&type=landline&index=1&country=US&pattern=example&features=SMS&search_pattern=0"

import requests
params = {
    "size": "10",
    "type": "landline",
    "index": "1",
    "country": "US",
    "pattern": "example",
    "features": "SMS",
    "search_pattern": "0"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/search",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/search');
url.searchParams.set('size', '10');
url.searchParams.set('type', 'landline');
url.searchParams.set('index', '1');
url.searchParams.set('country', 'US');
url.searchParams.set('pattern', 'example');
url.searchParams.set('features', 'SMS');
url.searchParams.set('search_pattern', '0');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/search")
	q := baseURL.Query()
	q.Set("size", "10")
	q.Set("type", "landline")
	q.Set("index", "1")
	q.Set("country", "US")
	q.Set("pattern", "example")
	q.Set("features", "SMS")
	q.Set("search_pattern", "0")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/search")
uri.query = URI.encode_www_form({
  "size" => "10",
  "type" => "landline",
  "index" => "1",
  "country" => "US",
  "pattern" => "example",
  "features" => "SMS",
  "search_pattern" => "0"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/search?" . http_build_query([
    "size" => "10",
    "type" => "landline",
    "index" => "1",
    "country" => "US",
    "pattern" => "example",
    "features" => "SMS",
    "search_pattern" => "0"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

POST Buy a number

Request to purchase a specific inbound number.

https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/buy

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/buy"

import requests
response = requests.post(
    "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/buy",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/buy';

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/buy"
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/buy")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/nexmo.com/numbers/1.0.20/number/buy";
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Numbers API?

Numbers API is a Company API. Developers commonly use company APIs for:

enriching CRM records with company firmographics
building lead-generation and prospecting tools
verifying business identity and registration details
monitoring competitors and market intelligence
powering B2B data enrichment pipelines

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Numbers API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide

Open documentation ↗