---
title: "List phone numbers"
method: GET
path: "/v1/phone-number"
tags: ["Phone Number"]
---

# List phone numbers

`GET /v1/phone-number`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/phone-number`
- Auth: HTTP bearer

Returns the phone numbers the project owns, oldest first, with the agent each is assigned to.

## Query parameters

- `agentId` string, uuid: Only the numbers assigned to this agent

## Response `200`

The phone numbers the project owns

- object
  - `data` PhoneNumberResponse[], required
    - `id` string, uuid, required: Phone number ID
    - `e164` string, required: The number in E.164 format
    - `name` string, nullable, required: Label the project gave the number
    - `localityCode` string, nullable, required: ISO 3166-2 code of the region the number is from, when the carrier gave one
    - `purchasedAt` string, required: When the number was bought (ISO 8601)
    - `rentNextChargeAt` string, required: When the next month of rent is due (ISO 8601)
    - `isFree` boolean, required: Whether the number sits inside the plan free allowance right now
    - `monthlyRentMicros` integer, required: What a month of this number costs in micro-dollars; 0 while it is free
    - `agentId` string, uuid, nullable, required: The agent the number is assigned to, if any

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-10-26** `0fb1c3b1940a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/phone-number/get.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/efc3377249d1?raw)