## List phone numbers

**get** `/v3/phone_numbers`

Returns all phone numbers assigned to the authenticated partner.
Use this endpoint to discover which phone numbers are available for
use as the `from` field when creating a chat, listing chats, or sending a voice memo.

### Returns

- `phone_numbers: array of object { id, phone_number, reputation, forwarding_number }`

  List of phone numbers assigned to the partner

  - `id: string`

    Unique identifier for the phone number

  - `phone_number: string`

    Phone number in E.164 format

  - `reputation: object { doc_url, status }`

    **[BETA]** Current reputation for a phone line. Always present — lines start at `HEALTHY` and may shift based on aggregate engagement and delivery signals across all conversations on the line.

    Unlike chat health, line reputation does not include `opted_out` — opt-out applies to individual recipients, not the whole line.

    See the [Phone Reputation guide](/channel/imessage/guides/phone-numbers/phone-reputation) for what each status means and how to react.

    - `doc_url: string`

      Deep-link to the relevant section of the Phone Reputation guide for this status.

    - `status: "HEALTHY" or "AT_RISK" or "CRITICAL"`

      Current reputation of this phone line.

      - `HEALTHY` — The line is in good standing. Send normally.
      - `AT_RISK` — Warning signs on the line: engagement is low across many of its conversations, or it's starting too many brand-new conversations in a single day — and a spike in send volume can add to either. Slow the line's send pace, avoid opening many new conversations at once, and review your messaging patterns.
      - `CRITICAL` — Strong signals that messages from this line aren't landing well. Pause outbound on the line until it recovers.

      Defaults to `HEALTHY` for lines that have not yet been scored.

      - `"HEALTHY"`

      - `"AT_RISK"`

      - `"CRITICAL"`

  - `forwarding_number: optional string`

    The forwarding number associated with this phone number, in E.164 format. Null when no forwarding number is configured.

### Example

```http
curl https://api.linqapp.com/api/partner/v3/phone_numbers \
    -H "Authorization: Bearer $LINQ_API_V3_API_KEY"
```

#### Response

```json
{
  "phone_numbers": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "phone_number": "+12025551234",
      "forwarding_number": "+12025559999",
      "reputation": {
        "status": "HEALTHY",
        "doc_url": "https://docs.linqapp.com/channel/imessage/guides/phone-numbers/phone-reputation#healthy"
      }
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "phone_number": "+12025559876",
      "forwarding_number": null,
      "reputation": {
        "status": "AT_RISK",
        "doc_url": "https://docs.linqapp.com/channel/imessage/guides/phone-numbers/phone-reputation#at-risk"
      }
    }
  ]
}
```