---
title: "List Phone Numbers (Deprecated)"
method: GET
path: "/agents/{agent_id}/phone-numbers"
tags: ["Agents"]
deprecated: true
---

# List Phone Numbers (Deprecated)

`GET /agents/{agent_id}/phone-numbers`

## Request

- Base URL: `https://api.cartesia.ai`
- URL: `https://api.cartesia.ai/agents/{agent_id}/phone-numbers`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/cartesia/apis/cartesia-api/docs/agents/:agent_id/phone-numbers/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

## Path parameters

- `agent_id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- PhoneNumber[]
  - `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.

---

[API](https://skmtc.dev/cartesia/apis/cartesia-api.md) - [All operations](https://skmtc.dev/cartesia/apis/cartesia-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cartesia/apis/cartesia-api/revisions/8910812440d3?raw)
