curl --request GET \
--url https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}', 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.sigmamind.ai/v1/phone-numbers/{phoneNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.sigmamind.ai/v1/phone-numbers/{phoneNumber}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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.sigmamind.ai/v1/phone-numbers/{phoneNumber}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"sipPhoneNumber": "+14155552671",
"provider": "twilio",
"inboundAgentId": "agent_D5D0p7TUs66TTAEAx",
"outboundAgentId": "agent_D5D0p7TUs66TTAEAx",
"outboundPhoneNumber": "+14155552671",
"active": true,
"terminationSipURI": "sip.telnyx.com",
"friendlyName": "Support Line - US"
}{
"error": "Bad Request",
"message": "Invalid request parameters",
"path": "/v1/phone-numbers",
"status": 400,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Unauthorized",
"message": "X-API-Key is missing or invalid",
"path": "/v1/phone-numbers",
"status": 401,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Forbidden",
"message": "Access denied for this resource",
"path": "/v1/phone-numbers",
"status": 403,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Not Found",
"message": "The requested resource was not found",
"path": "/v1/phone-numbers",
"status": 404,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Internal Server Error",
"message": "Unexpected server error",
"path": "/v1/phone-numbers",
"status": 500,
"timestamp": "2026-05-05T10:06:46.067Z"
}Get Phone Number
Retrieves the full configuration of a single phone number by its +E.164 value. Returns assigned agents, active status, provider, and SIP configuration for BYO numbers.
curl --request GET \
--url https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}', 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.sigmamind.ai/v1/phone-numbers/{phoneNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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.sigmamind.ai/v1/phone-numbers/{phoneNumber}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
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.sigmamind.ai/v1/phone-numbers/{phoneNumber}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sigmamind.ai/v1/phone-numbers/{phoneNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"sipPhoneNumber": "+14155552671",
"provider": "twilio",
"inboundAgentId": "agent_D5D0p7TUs66TTAEAx",
"outboundAgentId": "agent_D5D0p7TUs66TTAEAx",
"outboundPhoneNumber": "+14155552671",
"active": true,
"terminationSipURI": "sip.telnyx.com",
"friendlyName": "Support Line - US"
}{
"error": "Bad Request",
"message": "Invalid request parameters",
"path": "/v1/phone-numbers",
"status": 400,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Unauthorized",
"message": "X-API-Key is missing or invalid",
"path": "/v1/phone-numbers",
"status": 401,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Forbidden",
"message": "Access denied for this resource",
"path": "/v1/phone-numbers",
"status": 403,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Not Found",
"message": "The requested resource was not found",
"path": "/v1/phone-numbers",
"status": 404,
"timestamp": "2026-05-05T10:06:46.067Z"
}{
"error": "Internal Server Error",
"message": "Unexpected server error",
"path": "/v1/phone-numbers",
"status": 500,
"timestamp": "2026-05-05T10:06:46.067Z"
}Authorizations
Authenticate every request by passing your API key in the X-API-Key header. To get your key, go to Dashboard → API Keys and create or copy your Production API key.
Path Parameters
Phone number to retrieve, in +E.164 format. Obtained from the sipPhoneNumber field in the Create, Import, or List Phone Numbers response.
Response
OK
Caller phone number used to dial contacts in this campaign. This number appears as the caller ID on recipients' devices.
The caller’s phone number in +E.164 format. This number must be obtained from SigmaMind or configured using SIP trunking with SigmaMind.
"+14155552671"
The service provider associated with the phone number.
twilio, telnyx, byo "twilio"
Default agent ID assigned to handle inbound calls for this phone number.
"agent_D5D0p7TUs66TTAEAx"
Default agent ID assigned to handle outbound calls for this phone number.
"agent_D5D0p7TUs66TTAEAx"
The default outbound phone number of the callee, represented in +E.164 format
"+14155552671"
Indicates whether the phone number is currently active and available for use.
true
The SIP URI of the phone number, provided by the service provider for call termination.
"sip.telnyx.com"
A user-friendly display name assigned to this phone number.
"Support Line - US"