List WhatsApp phone numbers for the team

GET

/v1/ext/whatsapp-phone-number

Returns all WhatsApp Business phone numbers mapped to the authenticated team.

Optionally filter by pluginId to return only phone numbers linked to a
specific WhatsApp plugin.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Phone numbers retrieved successfully.

Bodyapplication/json

🟠401Unauthorized

🔴500InternalServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/ext/whatsapp-phone-number?pluginId=3fa85f64-5717-4562-b3fc-2c963f66afa6' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "_data": [
        {
            "id": "775966265503012",
            "waba": "102938475610293",
            "displayPhoneNumber": "+1 555-0100",
            "verifiedName": "Acme Support",
            "status": "CONNECTED",
            "qualityScore": {
                "score": "GREEN"
            },
            "messagingLimitTier": "TIER_10K",
            "codeVerificationStatus": "VERIFIED",
            "platformType": "CLOUD_API",
            "accountMode": "LIVE",
            "nameStatus": "APPROVED",
            "throughput": {
                "level": "STANDARD"
            },
            "isOfficialBusinessAccount": false,
            "lastOnboardedTime": "2024-06-01T12:00:00+0000",
            "chakraStatus": "CONNECTED"
        }
    ]
}

Modified at 2026-07-21 10:22:01

Fetch a WhatsApp Business Account by ID

Fetch a WhatsApp phone number by ID