v1

latestOpenAPI 3.0.32026-07-268345159.5 KB

WABA Management

Get Waba Info

Use this API to retrieve comprehensive WhatsApp Business Account (WABA) information and health status for your application. This endpoint provides critical details about account status, messaging capabilities, phone number quality, ownership, and any errors or limitations.

Important Requirements:

Valid app ID required
App must be WhatsApp Business API enabled
Rate limit: 10 requests per 60 seconds
PARTNER_APP role mandatory

Common Use Cases:

Monitor WABA account health and status
Check messaging availability before sending
Verify phone number and quality status
Diagnose account issues and errors
Validate account configuration
Track ownership and account type

Note: This endpoint provides real-time status information directly from WhatsApp Business API, including any active restrictions or limitations on the account.

get/partner/app/{appId}/waba/info

Path parameters

appIdstring required

The unique identifier of the partner application. Should be a valid appId.

Headers

Authorizationstring required

Your app token, please refer Get access token api to get the token from partner documentation.

Response

Successful Response - WABA information retrieved

statusstring

Response status indicator

Example response

{
  "status": "success",
  "wabaInfo": {
    "accountStatus": "ACTIVE",
    "dockerStatus": "CONNECTED",
    "messagingLimit": "TIER_1K",
    "mmLiteStatus": "ELIGIBLE",
    "ownershipType": "CLIENT_OWNED",
    "phone": "919876543210",
    "phoneQuality": "GREEN",
    "wabaId": "123456789012345",
    "canSendMessage": "AVAILABLE",
    "additionalInfo": [
      "Account is healthy",
      "All services operational"
    ],
    "errors": [
      {
        "error_code": "1001",
        "error_description": "Account temporarily restricted",
        "possible_solution": "Contact support to resolve restriction"
      }
    ]
  }
}