---
title: "List phones"
method: GET
path: "/api/v1/me/phones"
tags: ["Phones"]
---

# List phones

`GET /api/v1/me/phones`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/api/v1/me/phones`
- Auth: API key in cookie `auth_token`

List all phone numbers associated with the user account.

## Response `200`

List of phones

- object
  - `phones` UserPhone[], required
    - `id` string, required: MongoDB ObjectId
    - `phone` string, required
    - `is_primary` boolean, required
    - `verified_at` string, date-time
    - `created_at` string, date-time, required
    - `channel_metadata` object: Channel-specific metadata captured during verification
      - `telegram_chat_id` string: Telegram chat ID for HITL messaging
      - `telegram_user_id` string: Telegram user ID
      - `telegram_username` string: Telegram username

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/ce737ee02fac?raw)