MEmeta
Owned WhatsApp Business Accounts

Get Owned WhatsApp Business Accounts

Retrieve WhatsApp Business Accounts owned by the specified business. This endpoint provides comprehensive information about all WABAs owned by the business, including account details, configuration, and status information.

Use Cases:

  • Retrieve all WhatsApp Business Accounts owned by a business
  • Filter accounts by business type
  • Find specific accounts by ID
  • Monitor business portfolio of WhatsApp Business Accounts
  • Manage account access and permissions across multiple WABAs

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

Caching: Account information can be cached for short periods, but status and configuration may change frequently. Implement appropriate cache invalidation strategies.

get/{Version}/{Business-ID}/owned_whatsapp_business_accounts

Request

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

Path parameters

Versionstring required

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

Business-IDstring required

Your Business ID. This ID represents the business portfolio that owns the WhatsApp Business Accounts and can be found in your Business Manager settings.

Query parameters

business_typeWhatsAppBusinessType[]

Filter accounts by business type. Can specify multiple types as comma-separated values. Use this to filter between enterprise and small-medium business accounts.

[
  "ENTERPRISE"
]
afterstring

Cursor for forward pagination. Use the cursor from the previous response to get the next page of results.

firstinteger

Number of results to return in forward pagination. Maximum value is 100. Use with 'after' cursor for forward pagination.

beforestring

Cursor for backward pagination. Use the cursor from the previous response to get the previous page of results.

lastinteger

Number of results to return in backward pagination. Maximum value is 100. Use with 'before' cursor for backward pagination.

findstring

Find a specific WhatsApp Business Account by ID within the owned accounts. Use this to quickly locate a specific account.

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 owned WhatsApp Business Accounts

Example response

{
  "data": [
    {
      "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"
        }
      ]
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUjNpUWpVWmRBd0dn",
      "after": "QVFIUjNpUWpVWmRBd0Rn"
    },
    "previous": "https://graph.facebook.com/v23.0/1234567890/connected_client_businesses?before=QVFIUjNpUWpVWmRBd0Dn",
    "next": "https://graph.facebook.com/v23.0/1234567890/connected_client_businesses?after=QVFIUjNpUWpVWmRBd0Rn"
  }
}

Changes

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