## 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, health_status, phone_number }`

  List of phone numbers assigned to the partner

  - `id: string`

    Unique identifier for the phone number

  - `health_status: object { doc_url, status }`

    **[BETA]** Current health 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 health does not include `opted_out` — opt-out applies to individual recipients, not the whole line.

    See the [Phone Health guide](/guides/phone-numbers/phone-health) for what each status means and how to react.

    - `doc_url: string`

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

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

      Current health of this phone line as assessed by risk-service.

      - `HEALTHY` — No elevated risk detected.
      - `AT_RISK` — Elevated risk indicators present; consider reducing send volume or reviewing messaging patterns.
      - `CRITICAL` — High risk; further sending may result in line flagging or restriction.

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

      - `"HEALTHY"`

      - `"AT_RISK"`

      - `"CRITICAL"`

  - `phone_number: string`

    Phone number in E.164 format

### 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",
      "health_status": {
        "status": "HEALTHY",
        "doc_url": "https://docs.linqapp.com/guides/phone-numbers/phone-health#healthy"
      }
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "phone_number": "+12025559876",
      "health_status": {
        "status": "AT_RISK",
        "doc_url": "https://docs.linqapp.com/guides/phone-numbers/phone-health#at-risk"
      }
    }
  ]
}
```