---
title: "List WhatsApp phone numbers"
method: GET
path: "/orgs/connections/{connection_id}/whatsapp/phone-numbers"
tags: ["WhatsApp"]
---

# List WhatsApp phone numbers

`GET /orgs/connections/{connection_id}/whatsapp/phone-numbers`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/connections/{connection_id}/whatsapp/phone-numbers`
- Auth: HTTP bearer

List the phone numbers on the WhatsApp Business accounts of a connection, read through a Redis cache.

## Path parameters

- `connection_id` string, required

## Query parameters

- `page` number
- `take` number
- `next` string
- `progressive` boolean

## Response `200`

- WhatsAppPhoneNumberSchema[]
  - `id` string, required
  - `waba_id` string, required
  - `display_phone_number` string, required
  - `verified_name` string
  - `status` string
  - `quality_score` object
    - `score` string, required
  - `name_status` string
  - `messaging_limit_tier` string
  - `platform_type` string
  - `account_mode` string
  - `is_official_business_account` boolean
  - `is_pin_enabled` boolean
  - `health` WhatsAppHealthSchema
    - `can_send_message` string
    - `entities` WhatsAppHealthEntitySchema[]
      - `entity_type` string
      - `id` string
      - `can_send_message` string
      - `errors` WhatsAppHealthErrorSchema[]
        - `error_code` number
        - `error_description` string
        - `possible_solution` string
      - `additional_info` string[]

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)