Skip to main content
GET
/
api
/
v1
/
assistants
/
{assistant_id}
/
phone-numbers
Get Assistant Phone Numbers
curl --request GET \
  --url https://api.example.com/api/v1/assistants/{assistant_id}/phone-numbers \
  --header 'Authorization: Bearer <token>'
[
  {}
]
This endpoint retrieves a list of all phone numbers currently assigned to a specific assistant. This is useful for seeing which numbers will route incoming calls to this assistant.

​
Path Parameters

  • assistant_id (string, required): The unique identifier of the assistant whose phone numbers you want to list.

​
Response

The response is a JSON array of phone number objects. Each object contains details about the assigned phone number.
Response
[
  {
    "id": "pn_1a2b3c4d5e6f7g8h",
    "phone_number": "+15551234567",
    "assistant_id": "asst_a1b2c3d4e5f67890",
    "organization_id": "org_67890",
    "created_at": "2023-10-26T11:00:00Z",
    "updated_at": "2023-10-26T11:00:00Z"
  },
  {
    "id": "pn_9i8j7k6l5m4n3o2p",
    "phone_number": "+15557654321",
    "assistant_id": "asst_a1b2c3d4e5f67890",
    "organization_id": "org_67890",
    "created_at": "2023-10-27T12:30:00Z",
    "updated_at": "2023-10-27T12:30:00Z"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
assistant_id
integer
required

Response

Successful Response