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

Note

Messaging limits were previously calculated and set on a per-number basis. Starting October 7, 2025, messaging limits will instead be calculated and set on a business portfolio basis, and will be shared by all business phone numbers within each portfolio.

Request Parameters

Key	Description	Value	Constraints
PARTNER_APP_TOKEN	App Access Token issues post Partner login	{{PARTNER_APP_TOKEN}}	Should be a valid Partner app access token belonging to the passed appId
appId	App Id for the app that is linked to the Partner Account	{{APP_ID}}

Sample Request

curl --location --request GET '{{partner_portal_base_url}}/partner/app/:appId/waba/info' \
--header 'token: {{PARTNER_APP_TOKEN}}' \

Sample Response

{
	"status": "success",
	"wabaInfo": 
	{
		"accountStatus":"ACTIVE | BANNED",
		"dockerStatus":"CONNECTED | DISCONNECTED |FLAGGED | PENDING | RESTRICTED| UNKNOWN",
		"messagingLimit":"TIER_250 | TIER_2K | TIER_10K | TIER_100K |TIER_NOT_SET | TIER_UNLIMITED",
		"mmLiteStatus" :"INELIGIBLE | ELIGIBLE |ONBOARDED",
		"ownershipType":"CLIENT_OWNED |ON_BEHALF_OF | SELF",
		"phone": "{phone}",
		"phoneQuality": "GREEN| YELLOW | RED | UNKNOWN",
		"throughput": "HIGH |STANDARD | NOT_APPLICABLE",
		"verifiedName":"{display name}",
		"wabaId": "{waba_id}" ,
		"canSendMessage" :"AVAILABLE | LIMITED | BLOCKED",
		"errors": 
		[
			{
				"error_code":"141014",
				"error_description": "<error description>",
				"possible_solution": "<posiblesolution>"
			}
		],
			"additionalInfo": 
			[
				"Your display name has not been approved yet. Your message limit will increase after the display name is approved."
			]
	}
}

Status Codes

Status Code	Response	Comments
Success
200	{ "wabaInfo":{"accountStatus": "ACTIVE","dockerStatus": "CONNECTED","messagingLimit": "TIER_2K","mmLiteStatus" :"ELIGIBLE","ownershipType":"CLIENT_OWNED","phone": "917835039205","phoneQuality": "GREEN", "wabaId": "116676371511027", "canSendMessage": "LIMITED", "additionalInfo": [ "Your display name has not been approved yet. Your message limit will increase after the display name is approved." ] }, "status": "success" }	if canSendMessage is LIMITED
200	{ "wabaInfo":{ "accountStatus": "ACTIVE", "dockerStatus": "CONNECTED", "messagingLimit": "TIER_2K", "mmLiteStatus" :"ELIGIBLE", "ownershipType":"CLIENT_OWNED", "phone": "918375031069", "phoneQuality": "GREEN", "wabaId": "216141188246170", "canSendMessage": "AVAILABLE" }, "status": "success" }	if canSendMessage is AVAILABLE
200	{ "wabaInfo":{ "accountStatus": "ACTIVE", "dockerStatus": "PENDING", "mmLiteStatus" :"INELIGIBLE", "ownershipType":"ON_BEHALF_OF", "phone": "918657864833", "phoneQuality": "UNKNOWN", "wabaId": "101256882767341", "canSendMessage": "BLOCKED", "errors": [ { "error_code": "141001", "error_description": "The phone number you are trying to send messages with is not verified.", "possible_solution": "Register and finish the OTP authentication process for your phone number." }, { "error_code": "141000", "error_description": "The phone number you are trying to send messages from is not linked to your WhatsApp account.", "possible_solution": "Register and finish the OTP authentication process for your phone number." } ] }, "status": "success" }	if canSendMessage is BLOCKED
Error
400	{ "message": "App is not live.","status": "error"}	If app is not live
400	{ "message": "Waba id not found for the given App","status": "error"}	If waba id is not present in DB
400	{ "message": "WABA id is invalid or given phone is not associated with WABA","status": "error"}	If waba id present in DB is not correct
400	{ "message": "Error while getting waba info for given app","status": "error"}
401	{ "message": "Authentication Failed","status": "error"}
429	{ "status": "error","message": "Too Many Requests"}	10 Requests per Minute
500	{ "status": "error","message": "Internal Server Error"}	For any Internal Error