MEmeta
WhatsApp Business Account

Get WhatsApp Business Account Details

Retrieve comprehensive details about a WhatsApp Business Account, including its configuration, status, and settings.

Use Cases:

  • Retrieve WhatsApp Business Account configuration and details
  • Monitor account status and verification state
  • Check account ownership and business information
  • Validate account state before messaging operations

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

Caching: Account details can be cached for moderate periods, but verification status may change. Implement appropriate cache invalidation strategies.

get/{Version}/{WABA-ID}

Request

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

Path parameters

Versionstring required

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

WABA-IDstring required

Your WhatsApp Business Account ID. This ID is provided when you create the account and can be found in your WhatsApp Manager or through business management APIs.

Query parameters

fieldsstring

Comma-separated list of fields to include in the response. If not specified, default fields will be returned (id, name). Available fields: id, name, timezone_id, message_template_namespace, account_review_status, business_verification_status, country, ownership_type, primary_business_location

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 WhatsApp Business Account details

idstring required

Unique identifier for the WhatsApp Business Account

namestring required

Human-readable name of the WhatsApp Business Account

account_review_status'APPROVED' | 'PENDING' | 'REJECTED' | 'RESTRICTED'

Review status of the WhatsApp Business Account

purchase_order_numberstring

Purchase order number associated with the account

audiencesstring[]

List of audience segments associated with the account

ownership_type'SELF_OWNED' | 'CLIENT_OWNED' | 'AGENCY_OWNED'

Type of ownership for the WhatsApp Business Account

business_verification_status'VERIFIED' | 'UNVERIFIED' | 'PENDING' | 'REJECTED'

Verification status of the connected client business

countrystring

Country code where the WABA is registered

currencystring

Currency code for the WABA

timezone_idstring

Timezone identifier for the WABA

is_enabled_for_insightsboolean

Whether insights are enabled for this WABA

Example response

{
  "id": "1234567890123456",
  "name": "My WhatsApp Business Account",
  "account_review_status": "APPROVED",
  "purchase_order_number": "PO-2023-001234",
  "audiences": [
    "customers",
    "prospects"
  ],
  "ownership_type": "CLIENT_OWNED",
  "subscribed_apps": [
    {
      "id": "9876543210987654",
      "name": "WhatsApp Integration App"
    }
  ],
  "business_verification_status": "VERIFIED",
  "country": "US",
  "currency": "USD",
  "timezone_id": "1",
  "on_behalf_of_business_info": {
    "id": "5678901234567890",
    "name": "Partner Business Inc"
  },
  "schedules": [
    {
      "day_of_week": "MONDAY",
      "open_time": "09:00",
      "close_time": "17:00"
    }
  ],
  "is_enabled_for_insights": true,
  "dcc_config": {
    "enabled": true,
    "policy_url": "https://example.com/dcc-policy"
  },
  "message_templates": [
    {
      "id": "template_123456",
      "name": "welcome_message",
      "status": "APPROVED"
    }
  ],
  "phone_numbers": [
    {
      "id": "1234567890123456",
      "display_phone_number": "+1 (555) 123-4567",
      "verified_name": "Example Business"
    }
  ]
}

Changes

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