cURL
curl --request GET \
--url https://api.zudu.ai/api/phone-numbers/{phoneNumber} \
--header 'X-API-KEY: <api-key>' \
--header 'X-API-SECRET: <api-key>'import requests
url = "https://api.zudu.ai/api/phone-numbers/{phoneNumber}"
headers = {
"X-API-KEY": "<api-key>",
"X-API-SECRET": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-API-KEY': '<api-key>', 'X-API-SECRET': '<api-key>'}
};
fetch('https://api.zudu.ai/api/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.zudu.ai/api/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>",
"X-API-SECRET: <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.zudu.ai/api/phone-numbers/{phoneNumber}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("X-API-SECRET", "<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.zudu.ai/api/phone-numbers/{phoneNumber}")
.header("X-API-KEY", "<api-key>")
.header("X-API-SECRET", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zudu.ai/api/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>'
request["X-API-SECRET"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"message": "Phone number retrieved successfully",
"status": "success",
"error": null,
"data": {
"phone_number": "+14157774444",
"organization_id": "org_123",
"phone_number_pretty": "+1 (415) 777-4444",
"area_code": 415,
"nickname": "Customer Service Line",
"phone_number_type": "zudu-twilio",
"inbound_agent_id": "agent_abc123",
"outbound_agent_id": "agent_xyz789",
"inbound_agent_version": 1,
"outbound_agent_version": 1,
"inbound_webhook_url": "https://example.com/webhook",
"number_provider": "twilio",
"outbound_trunk_id": "ST_4Xo2mZgQsfyQ",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"last_modification_timestamp": 1703413636133
}
}Phone Numbers
Get phone number
Retrieves a phone number (current behavior).
GET
/
api
/
phone-numbers
/
{phoneNumber}
cURL
curl --request GET \
--url https://api.zudu.ai/api/phone-numbers/{phoneNumber} \
--header 'X-API-KEY: <api-key>' \
--header 'X-API-SECRET: <api-key>'import requests
url = "https://api.zudu.ai/api/phone-numbers/{phoneNumber}"
headers = {
"X-API-KEY": "<api-key>",
"X-API-SECRET": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-API-KEY': '<api-key>', 'X-API-SECRET': '<api-key>'}
};
fetch('https://api.zudu.ai/api/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.zudu.ai/api/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>",
"X-API-SECRET: <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.zudu.ai/api/phone-numbers/{phoneNumber}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("X-API-SECRET", "<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.zudu.ai/api/phone-numbers/{phoneNumber}")
.header("X-API-KEY", "<api-key>")
.header("X-API-SECRET", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zudu.ai/api/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>'
request["X-API-SECRET"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"message": "Phone number retrieved successfully",
"status": "success",
"error": null,
"data": {
"phone_number": "+14157774444",
"organization_id": "org_123",
"phone_number_pretty": "+1 (415) 777-4444",
"area_code": 415,
"nickname": "Customer Service Line",
"phone_number_type": "zudu-twilio",
"inbound_agent_id": "agent_abc123",
"outbound_agent_id": "agent_xyz789",
"inbound_agent_version": 1,
"outbound_agent_version": 1,
"inbound_webhook_url": "https://example.com/webhook",
"number_provider": "twilio",
"outbound_trunk_id": "ST_4Xo2mZgQsfyQ",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z",
"last_modification_timestamp": 1703413636133
}
}Notes
- Retrieves a specific phone number by its E.164 format
Authorizations
API Key for MCP server and external service authentication
API Secret for MCP server and external service authentication
Path Parameters
E.164 format phone number (e.g. +14157774444)
⌘I