Fetch a WhatsApp phone number by ID

GET

/v1/ext/whatsapp-phone-number/{whatsappPhoneNumberId}

Returns curated details for a WhatsApp Business phone number.

The phone number must be mapped to the authenticated team. Unknown IDs
and IDs belonging to other teams both return a not-found error.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Phone number retrieved successfully.

Bodyapplication/json

🟠400PhoneNumberNotFound

🟠401Unauthorized

🔴500InternalServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/ext/whatsapp-phone-number/775966265503012' \
--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:21

List WhatsApp phone numbers for the team

Deregister a WhatsApp business phone number