Get Phone Number

GET

organization-phone-numbers

{id}

Get a phone number by ID

curl --request GET \
  --url https://api.dialnexa.com/organization-phone-numbers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-organization-id: <x-organization-id>'

import requests

url = "https://api.dialnexa.com/organization-phone-numbers/{id}"

headers = {
    "x-organization-id": "<x-organization-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-organization-id': '<x-organization-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.dialnexa.com/organization-phone-numbers/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/organization-phone-numbers/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "x-organization-id: <x-organization-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.dialnexa.com/organization-phone-numbers/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-organization-id", "<x-organization-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.dialnexa.com/organization-phone-numbers/{id}")
  .header("x-organization-id", "<x-organization-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/organization-phone-numbers/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-organization-id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "sip_trunk_enabled": false
}

Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.

Returns the full record for a single purchased phone number: the E.164 phone_number, the country_code, the type (local, toll-free, or mobile), the monthly rental cost, the supported capabilities (voice, SMS where available), the display nickname, the currently assigned inbound_agent_id, and the purchase timestamp.

When to use this

Number management UIs: render the per-number detail view in a phone-number management page.
Routing audits: verify which agent is currently handling inbound calls on a specific number before making changes.
Cost attribution: pull monthly_cost_usd to attribute telephony spend per workspace or per use case in internal reports.
Compliance reviews: confirm the number’s country and capabilities match the use case it is being used for.

For the entire portfolio of numbers on the workspace, use List Phone Numbers.

Path parameters

Parameter	Description
`id`	The phone number ID, for example `phn_f7w2kx5mb9qz`.

Errors

404 Not Found is returned when the number does not exist on this workspace.
403 Forbidden is returned when the API key cannot read phone number records.

List Phone Numbers: see every number on the workspace.
Update Phone Number: change the nickname or reassign the inbound agent.
Release a Number: release a number back to the provider’s pool.
Buy a Phone Number: purchase a new number.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-organization-id

string

required

RSA-encrypted organization_id string (base64 format)

Path Parameters

string

required

Response

Phone number found.

sip_trunk_enabled

boolean

default:false

required

When true, Speech IO uses SIP trunking (e.g. asterisk) for this number.

Search Available NumbersSearch for phone numbers available to purchase, filtered by country, type, or area code.

Get a phone number by ID

curl --request GET \
  --url https://api.dialnexa.com/organization-phone-numbers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-organization-id: <x-organization-id>'

import requests

url = "https://api.dialnexa.com/organization-phone-numbers/{id}"

headers = {
    "x-organization-id": "<x-organization-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-organization-id': '<x-organization-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.dialnexa.com/organization-phone-numbers/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/organization-phone-numbers/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "x-organization-id: <x-organization-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.dialnexa.com/organization-phone-numbers/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-organization-id", "<x-organization-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.dialnexa.com/organization-phone-numbers/{id}")
  .header("x-organization-id", "<x-organization-id>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/organization-phone-numbers/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-organization-id"] = '<x-organization-id>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "sip_trunk_enabled": false
}

Overview

Endpoints - v1

Endpoints - Legacy

Code Examples And SDK Status

When to use this

Path parameters

Errors

Authorizations

Headers

Path Parameters

Response

​When to use this

​Path parameters

​Errors

​Related endpoints

Authorizations

Headers

Path Parameters

Response

When to use this

Path parameters

Errors

Related endpoints