MEmeta
Official Business Account

Get Official Business Account Status

Retrieve the Official Business Account (OBA) status and related information for a WhatsApp Business Account phone number.

Use Cases:

  • Check current OBA verification status
  • Monitor OBA application progress
  • Retrieve status messages for business account verification
  • Validate business credibility status

Rate Limiting: Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

Caching: OBA status information can be cached for moderate periods, but status may change during verification processes. Implement appropriate cache invalidation strategies.

get/{Version}/{Phone-Number-ID}/official_business_account

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/official_business_account
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Phone-Number-IDstring required

Your WhatsApp Business phone number ID. This ID represents the phone number status entity and can be obtained from your WhatsApp Business Account phone numbers list.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (oba_status, status_message). Available fields: oba_status, status_message

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Response

Successfully retrieved Official Business Account status

idstring required

Unique identifier for the WhatsApp Business Account phone number

oba_status'PENDING' | 'APPROVED' | 'REJECTED' | 'UNDER_REVIEW' | 'EXPIRED' | 'CANCELLED' required

Official Business Account appeal and verification status

status_messagestring required

Human-readable message describing the current Official Business Account status

Example response

{
  "id": "1234567890123456",
  "oba_status": "PENDING",
  "status_message": "Your Official Business Account application is under review"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.