---
title: "List phone numbers"
method: GET
path: "/projects/{project_id}/agent/phones"
tags: ["Agent"]
---

# List phone numbers

`GET /projects/{project_id}/agent/phones`

## Request

- Base URL: `https://api.beyondwords.io/v1`
- URL: `https://api.beyondwords.io/v1/projects/{project_id}/agent/phones`
- Auth: API key in header `X-Api-Key`

List the Twilio phone numbers connected to the agent

## Response `200`

lists configured phone numbers

- AgentPhoneModel[]
  - `id` string: Unique identifier for the phone number
  - `type` string: The channel type. Currently always `telephony`.
  - `provider` string: The telephony provider. Currently always `twilio`.
  - `label` string: A human-readable label for the phone number
  - `phone_number` string: The phone number in E.164 format
  - `elevenlabs_channel_id` string: The identifier of the phone number in ElevenLabs
  - `enabled` boolean: Whether the agent currently answers calls on this number. Disabling it detaches the number from the agent in ElevenLabs without deleting the number itself.
  - `created_at` string, date-time: Time at which the object was created (ISO 8601)

## Other responses

- `404`: Agent beta not enabled for this organization

## Changes

- **2026-11-03** `994b9853e685`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/changes/projects/:project_id/agent/phones/get.md)

---

[API](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api.md) - [All operations](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondwords/apis/beyondwords-rest-api/revisions/994b9853e685?raw)