List Phone Numbers | Resemble

Retrieve all phone numbers for the authenticated team, optionally filtered by agent or availability.

HTTP Request

$ GET https://app.resemble.ai/api/v2/phone_numbers

Alternative Endpoints

$ # List phone numbers for specific agent
> GET https://app.resemble.ai/api/v2/agents/{agent_uuid}/phone_numbers
> 
> # List only available (unlinked) phone numbers
> GET https://app.resemble.ai/api/v2/phone_numbers?available=true

Query Parameters

Parameter	Type	Description
available	boolean	Filter for unlinked phone numbers (optional)

Example Requests

List All Phone Numbers

$ curl --request GET "https://app.resemble.ai/api/v2/phone_numbers" \
>   -H "Authorization: Bearer YOUR_API_TOKEN" \
>   -H "Content-Type: application/json"

List Phone Numbers for Specific Agent

$ curl --request GET "https://app.resemble.ai/api/v2/agents/550e8400-e29b-41d4-a716-446655440000/phone_numbers" \
>   -H "Authorization: Bearer YOUR_API_TOKEN" \
>   -H "Content-Type: application/json"

List Only Available Phone Numbers

$ curl --request GET "https://app.resemble.ai/api/v2/phone_numbers?available=true" \
>   -H "Authorization: Bearer YOUR_API_TOKEN" \
>   -H "Content-Type: application/json"

Response

1 {
2   "success": true,
3   "items": [
4     {
5       "id": 1,
6       "phone_number": "+14155551234",
7       "label": "Support Line",
8       "supports_inbound": true,
9       "supports_outbound": false,
10       "provider": "twilio",
11       "status": "active",
12       "agent_id": 123,
13       "agent_name": "Customer Support Agent",
14       "agent_uuid": "550e8400-e29b-41d4-a716-446655440000",
15       "outbound_trunk": {
16         "twilio_trunk_sid": "TK...",
17         "domain_name": "example.pstn.twilio.com",
18         "configured": true,
19         "configured_at": "2025-01-27T10:00:00Z"
20       },
21       "inbound_trunk": {
22         "twilio_trunk_sid": "TK...",
23         "domain_name": "example.pstn.twilio.com",
24         "configured": true,
25         "configured_at": "2025-01-27T10:00:00Z",
26         "livekit_trunk_id": "TR_...",
27         "livekit_dispatch_rule_id": "DR_...",
28         "livekit_configured": true,
29         "livekit_configured_at": "2025-01-27T10:00:00Z"
30       },
31       "twilio_account_sid": "AC...",
32       "has_twilio_credentials": true,
33       "created_at": "2025-01-27T10:00:00Z",
34       "updated_at": "2025-01-27T10:00:00Z"
35     }
36   ],
37   "count": 1
38 }

Response Body

Attribute	Type	Description
success	boolean	Indicates if the request was successful
items	array	Array of phone number objects
count	integer	Total number of phone numbers
id	integer	Phone number ID
phone_number	string	E.164 formatted phone number
label	string	Human-readable label
supports_inbound	boolean	Whether inbound calls are supported
supports_outbound	boolean	Whether outbound calls are supported
provider	string	Provider: “twilio”
status	string	Status: “active”, “corrupted”, or “deleting”
agent_id	integer	Linked agent ID (null if unlinked)
agent_name	string	Linked agent name (null if unlinked)
agent_uuid	string	Linked agent UUID (null if unlinked)
outbound_trunk	object	Outbound trunk configuration
inbound_trunk	object	Inbound trunk configuration
twilio_account_sid	string	Twilio account SID
has_twilio_credentials	boolean	Whether Twilio auth token is configured
created_at	string	ISO8601 timestamp
updated_at	string	ISO8601 timestamp

Outbound Trunk Object

Attribute	Type	Description
twilio_trunk_sid	string	Twilio SIP trunk SID
domain_name	string	SIP domain name
configured	boolean	Whether trunk is configured
configured_at	string	ISO8601 timestamp of configuration

Inbound Trunk Object

Attribute	Type	Description
twilio_trunk_sid	string	Twilio SIP trunk SID
domain_name	string	SIP domain name
configured	boolean	Whether Twilio trunk is configured
configured_at	string	ISO8601 timestamp of Twilio configuration
livekit_trunk_id	string	LiveKit trunk ID
livekit_dispatch_rule_id	string	LiveKit dispatch rule ID
livekit_configured	boolean	Whether LiveKit is configured
livekit_configured_at	string	ISO8601 timestamp of LiveKit configuration