List Phone Numbers

curl --request GET \
  --url https://api.cartesia.ai/agents/{agent_id}/phone-numbers \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'

[
  {
    "agent_id": "<string>",
    "number": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "is_cartesia_managed": true
  }
]

GET

agents

{agent_id}

phone-numbers

List Phone Numbers

curl --request GET \
  --url https://api.cartesia.ai/agents/{agent_id}/phone-numbers \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>'

[
  {
    "agent_id": "<string>",
    "number": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "is_cartesia_managed": true
  }
]

Authorizations

Authorization

string

header

required

Cartesia API key

Headers

Cartesia-Version

enum<string>

required

API version header. Must be set to the API version, e.g. '2024-06-10'.

Available options:

2024-06-10,

2024-11-13,

2025-04-16

Example:

"2025-04-16"

Path Parameters

agent_id

string

required

The ID of the agent.

Response

200 - application/json

agent_id

string

required

The ID of the agent.

number

string

required

The phone number.

created_at

string<date-time>

required

The UTC timestamp when the phone number was created.

updated_at

string<date-time>

required

The UTC timestamp when the phone number was last updated.

is_cartesia_managed

boolean

required

Whether the phone number is managed by Cartesia. As of now, this is always true since Cartesia provisions phone numbers for you.

⌘I