List Assigned Phone Numbers

[
  {}
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

GET

api

assistants

{assistant_id}

phone-numbers

[
  {}
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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

API Documentation

Assistants

Assistant Phone Numbers

Assistant Documents (RAG)

Voice Cloning

Calls

Messaging

SIP Trunks

Billing

Phone Number Management

Call Data

Organization

Webhooks & System

Campaigns

WebSockets

Tools & Custom Actions

Conversation Flows

Learning & Memory

Path Parameters

Response

Authorizations

Path Parameters

Response

​Path Parameters

​Response

Authorizations

Path Parameters

Response

Path Parameters

Response