{
"offset": 1,
"limit": 2,
"length": 1,
"total": 1,
"items": [
{
"id": "1234567890123456",
"phoneNumber": "+16315551111",
"displayPhoneNumber": "+1 631-555-1111",
"wabaId": "whatsapp-business-account-id",
"businessUsername": "acme.support",
"businessUsernameStatus": "not_set",
"requestedBusinessUsername": "acme.help",
"businessUsernameUpdatedAt": "2026-05-26T12:00:00.000Z",
"qualityRating": "GREEN",
"messagingLimit": "TIER_1K",
"whatsappBusinessManagerMessagingLimit": "TIER_2K",
"verifiedName": "John's Cake Shop",
"ycloudName": "Support line",
"newName": "John's Cake",
"codeVerificationStatus": "VERIFIED",
"isOfficialBusinessAccount": true,
"status": "PENDING",
"nameStatus": "APPROVED",
"newNameStatus": "APPROVED",
"decision": "APPROVED",
"requestedVerifiedName": "<string>",
"rejectionReason": "<string>",
"qualityUpdateEvent": "ONBOARDING",
"updateEvent": "ACCOUNT_OFFBOARDED",
"throughputLevel": "HIGH"
}
]
}List phone numbers
Returns a paginated list of WhatsApp business phone numbers you’ve registered.
{
"offset": 1,
"limit": 2,
"length": 1,
"total": 1,
"items": [
{
"id": "1234567890123456",
"phoneNumber": "+16315551111",
"displayPhoneNumber": "+1 631-555-1111",
"wabaId": "whatsapp-business-account-id",
"businessUsername": "acme.support",
"businessUsernameStatus": "not_set",
"requestedBusinessUsername": "acme.help",
"businessUsernameUpdatedAt": "2026-05-26T12:00:00.000Z",
"qualityRating": "GREEN",
"messagingLimit": "TIER_1K",
"whatsappBusinessManagerMessagingLimit": "TIER_2K",
"verifiedName": "John's Cake Shop",
"ycloudName": "Support line",
"newName": "John's Cake",
"codeVerificationStatus": "VERIFIED",
"isOfficialBusinessAccount": true,
"status": "PENDING",
"nameStatus": "APPROVED",
"newNameStatus": "APPROVED",
"decision": "APPROVED",
"requestedVerifiedName": "<string>",
"rejectionReason": "<string>",
"qualityUpdateEvent": "ONBOARDING",
"updateEvent": "ACCOUNT_OFFBOARDED",
"throughputLevel": "HIGH"
}
]
}Authorizations
Query Parameters
Page number of the results to be returned, 1-based.
1 <= x <= 100A limit on the number of results to be returned, or number of results per page, between 1 and 100, defaults to 10.
1 <= x <= 100Return results inside an object that contains the total result count or not.
Required if you have more than 100 WABAs. WhatsApp Business Account ID.
"whatsapp-business-account-id"
Response
Successfully retrieved a paginated list of objects.
Represents a given page of WhatsApp phone numbers.
The position of the item this page starts from, zero-based. e.g., the 11th item is at offset 10.
x >= 0A limit on the number of items to be returned, between 1 and 100, defaults to 10.
x >= 1The actual number of items in the page.
x >= 0The total number of items. This field is returned only when the request parameter includeTotal is set to true.
x >= 0An array containing WhatsApp phone number objects.
Show child attributes
Show child attributes