---
title: "GetPhoneNumberList"
method: GET
path: "/api/v1/whatsApp/phoneNumbers"
tags: ["WhatsAppAccounts"]
---

# GetPhoneNumberList

`GET /api/v1/whatsApp/phoneNumbers`

## Response `200`

Get WhatsApp phone number list success

- object
  - `ok` boolean — Indicates whether the request was successful.
  - `result` object[] — List of WhatsApp phone numbers and their associated metadata.
    - `phoneId` string — Unique identifier of the WhatsApp phone number in the provider system.
    - `accountMode` string — Mode of the account, e.g. LIVE or SANDBOX.
    - `codeVerificationStatus` string — Verification status of the phone number (e.g. VERIFIED/ NOT_VERIFIED/ EXPIRED).
    - `displayPhoneNumber` string — Human-readable phone number displayed in WhatsApp.
    - `messagingLimitTier` string — Messaging limit tier for the phone number (e.g. TIER_1K).
    - `nameStatus` string — Status of the display name approval (e.g. APPROVED).
    - `newNameStatus` string — New name status if there is a pending name change, otherwise 'NONE'.
    - `qualityScore` string — Quality score of the phone number (e.g. GREEN, YELLOW, RED).
    - `status` string — Connection status of the phone number (e.g. CONNECTED, DISCONNECTED).
    - `verifiedName` string — Verified business name associated with this phone number.
    - `wabaId` string — WhatsApp Business Account ID that owns this phone number.
    - `accountReviewStatus` string — Review status of the WhatsApp Business Account (e.g. APPROVED REJECTED DEFERRED).
    - `businessVerificationStatus` string — Business verification status (e.g. verified, unverified).
    - `qualityRating` string — Overall quality rating: GREEN = high quality, YELLOW = medium quality, RED = low quality, UNKNOWN = unknown quality.

---

[API](https://skmtc.dev/wati/apis/api-documentation-v3.md) · [All operations](https://skmtc.dev/wati/apis/api-documentation-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wati/api-documentation-v3/revisions/dee16d2c7d41/schema)