Skip to Content
API ReferenceWhatsAppMessaging Limit

Messaging Limit

Returns the current messaging tier for one phone number. Meta scales tiers automatically based on quality + activity:

TIER_50 → TIER_250 → TIER_1K → TIER_10K → TIER_100K → TIER_UNLIMITED

This is a focused fields= view of the same endpoint as Phone Number Details.

GET /api/v25.0/{PHONE_NUMBER_ID}?fields=whatsapp_business_manager_messaging_limit,messaging_limit_tier Authorization: Bearer pk_live_<your-key>

Customer-scoped alias

GET /api/v1/partner/customers/{customer_id}/whatsapp/phone-numbers/{phone_number_id}/messaging-limit

The alias is a fixed-query shortcut — it injects fields=whatsapp_business_manager_messaging_limit,messaging_limit_tier for you. You can still pass your own fields= to override.

Response — 200

{ "whatsapp_business_manager_messaging_limit": "TIER_2K", "id": "993857633806592" }
FieldNotes
whatsapp_business_manager_messaging_limitActive tier
idThe phone-number ID you queried

Errors

Same matrix as Phone Number Details.

cURL

curl -X GET \ "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID?fields=whatsapp_business_manager_messaging_limit,messaging_limit_tier" \ -H "Authorization: Bearer $SPLASHIFY_API_KEY"

Notes

  • Tier transitions are gradual. When Meta promotes a number to a higher tier, the change can take an hour or two to surface here.