Retrieve all phone numbers for the authenticated team, optionally filtered by agent or availability.
$ GET https://app.resemble.ai/api/v2/phone_numbers
$ # 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
| Parameter | Type | Description |
|---|---|---|
| available | boolean | Filter for unlinked phone numbers (optional) |
$ curl --request GET "https://app.resemble.ai/api/v2/phone_numbers" \ > -H "Authorization: Bearer YOUR_API_TOKEN" \ > -H "Content-Type: application/json"
$ 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"
$ curl --request GET "https://app.resemble.ai/api/v2/phone_numbers?available=true" \ > -H "Authorization: Bearer YOUR_API_TOKEN" \ > -H "Content-Type: application/json"
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 }
| 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 |
| 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 |
| 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 |