List phone numbers

GET https://api.elevenlabs.io/v1/convai/phone-numbers

Retrieve all Phone Numbers

Reference: https://elevenlabs.io/docs/api-reference/phone-numbers/list

• https://api.elevenlabs.io (Production, default)
• https://api.us.elevenlabs.io (Production US)
• https://api.eu.residency.elevenlabs.io (Production EU)
• https://api.in.residency.elevenlabs.io (Production India)
• https://api.sg.residency.elevenlabs.io (Production Singapore)

• provider (enum, optional, nullable) — Filter by telephony provider
  • Allowed values: twilio, sip_trunk, exotel
• agent_id (string, optional, nullable) — Filter by assigned agent ID
• branch_id (string, optional, nullable) — Filter by assigned branch ID

Successful Response

• list of V1ConvaiPhoneNumbersGetResponsesContentApplicationJsonSchemaItems

Validation Error

• detail (list of ValidationError, optional)

• provider: twilio (GetPhoneNumberTwilioResponseModel)
  • label (string, required) — Label for the phone number
  • phone_number (string, required) — Phone number
  • phone_number_id (string, required) — The ID of the phone number
  • assigned_agent (PhoneNumberAgentInfo, optional, nullable) — The agent that is assigned to the phone number
  • supports_inbound (boolean, optional, default: true, deprecated) — This field is deprecated and will be removed in the future. Whether this phone number supports inbound calls
  • supports_outbound (boolean, optional, default: true, deprecated) — This field is deprecated and will be removed in the future. Whether this phone number supports outbound calls
• provider: exotel (GetPhoneNumberExotelResponseModel)
  • label (string, required) — Label for the phone number
  • phone_number (string, required) — Phone number
  • phone_number_id (string, required) — The ID of the phone number
  • assigned_agent (PhoneNumberAgentInfo, optional, nullable) — The agent that is assigned to the phone number
  • supports_inbound (boolean, optional, default: true, deprecated) — This field is deprecated and will be removed in the future. Whether this phone number supports inbound calls
  • supports_outbound (boolean, optional, default: true, deprecated) — This field is deprecated and will be removed in the future. Whether this phone number supports outbound calls
• provider: sip_trunk (GetPhoneNumberSIPTrunkResponseModel)
  • label (string, required) — Label for the phone number
  • livekit_stack (enum, required, default: standard) — Type of Livekit stack used for this number.
    • Allowed values: standard, static
  • phone_number (string, required) — Phone number
  • phone_number_id (string, required) — The ID of the phone number
  • assigned_agent (PhoneNumberAgentInfo, optional, nullable) — The agent that is assigned to the phone number
  • inbound_trunk (GetPhoneNumberInboundSIPTrunkConfigResponseModel, optional, nullable) — Configuration of the Inbound SIP trunk - if configured.
  • outbound_trunk (GetPhoneNumberOutboundSIPTrunkConfigResponseModel, optional, nullable) — Configuration of the Outbound SIP trunk - if configured.
  • store_sip_messages (boolean, optional, default: true) — Whether to store SIP messages for this phone number.
  • provider_config (GetPhoneNumberOutboundSIPTrunkConfigResponseModel, optional, nullable, deprecated) — SIP Trunk configuration details for a phone number
  • supports_inbound (boolean, optional, default: true, deprecated) — This field is deprecated and will be removed in the future. Whether this phone number supports inbound calls
  • supports_outbound (boolean, optional, default: true, deprecated) — This field is deprecated and will be removed in the future. Whether this phone number supports outbound calls

• loc (list of ValidationErrorLocItems, required)
• msg (string, required)
• type (string, required)

• agent_id (string, required) — The ID of the agent
• agent_name (string, required) — The name of the agent
• environment (string, optional, nullable) — Environment to use for resolving environment variables on calls to this number.
• branch_id (string, optional, nullable) — Agent branch to use for calls to this number.

• allowed_addresses (list of string, required) — List of IP addresses that are allowed to use the trunk. Each item in the list can be an individual IP address or a Classless Inter-Domain Routing notation representing a CIDR block.
• allowed_numbers (list of string, required, nullable) — List of phone numbers that are allowed to use the trunk.
• media_encryption (enum, required, default: allowed)
  • Allowed values: disabled, allowed, required
• has_auth_credentials (boolean, required) — Whether authentication credentials are configured
• username (string, optional, nullable) — SIP trunk username (if available)
• remote_domains (list of string, optional, nullable) — Domains of remote SIP servers used to validate TLS certificates.
• attributes_to_headers (map from string to string, optional) — Map of dynamic variable name to header name for attributes_to_headers

SIP Trunk configuration details for a phone number

• address (string, required) — Hostname or IP the SIP INVITE is sent to
• transport (enum, required, default: auto) — Protocol to use for SIP transport
  • Allowed values: auto, udp, tcp, tls
• media_encryption (enum, required, default: allowed) — Whether or not to encrypt media (data layer).
  • Allowed values: disabled, allowed, required
• has_auth_credentials (boolean, required) — Whether authentication credentials are configured
• headers (map from string to string, optional) — SIP headers for INVITE request
• attributes_to_headers (map from string to string, optional) — Map of dynamic variable name to header name for attributes_to_headers
• username (string, optional, nullable) — SIP trunk username (if available)
• has_outbound_trunk (boolean, optional, default: false) — Whether a LiveKit SIP outbound trunk is configured
• enabled_codecs (list of enum, optional) — Media codecs that are offered in the SDP for outbound calls. If empty, all supported codecs are offered.
  • Allowed values: G722/8000, PCMU/8000, PCMA/8000

Response

[
  {
    "provider": "twilio",
    "label": "Customer Support",
    "phone_number": "+1234567890",
    "phone_number_id": "phone_123"
  }
]

SDK Code

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

async function main() {
    const client = new ElevenLabsClient();
    await client.conversationalAi.phoneNumbers.list({});
}
main();

from elevenlabs import ElevenLabs

client = ElevenLabs()

client.conversational_ai.phone_numbers.list()

package main

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

func main() {

	url := "https://api.elevenlabs.io/v1/convai/phone-numbers"

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

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

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

	fmt.Println(res)
	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/phone-numbers")

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

request = Net::HTTP::Get.new(url)

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

import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.elevenlabs.io/v1/convai/phone-numbers")
  .asString();

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.elevenlabs.io/v1/convai/phone-numbers');

echo $response->getBody();

using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/phone-numbers");
var request = new RestRequest(Method.GET);
IRestResponse response = client.Execute(request);

import Foundation

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/phone-numbers")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()