---
title: "Get Client WhatsApp Business Accounts"
method: GET
path: "/{Version}/{Business-ID}/client_whatsapp_business_accounts"
tags: ["Client WhatsApp Business Accounts"]
---

# Get Client WhatsApp Business Accounts

`GET /{Version}/{Business-ID}/client_whatsapp_business_accounts`

## Request

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

Retrieve a list of WhatsApp Business Accounts that have been shared with the specified business.


**Use Cases:**
- Monitor shared WABA relationships and permissions
- Verify WABA configuration and status information
- Retrieve WABA details for business integrations
- Manage multi-business WhatsApp messaging setups


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


**Caching:**
WABA information can be cached for moderate periods, but status information may change
frequently. Implement appropriate cache invalidation strategies.

## Path parameters

- `Version` string, required
- `Business-ID` string, required

## Query parameters

- `fields` string
- `business_type` string[]
- `limit` integer
- `after` string
- `before` string
- `find` string

## Headers

- `User-Agent` string
- `Authorization` string, required

## Response `200`

Successfully retrieved client WhatsApp Business Accounts

- ClientWhatsAppBusinessAccountsResponse: Response containing list of client WhatsApp Business Accounts
  - `data` WhatsAppBusinessAccount[]: Array of client WhatsApp Business Accounts
    - `id` string, required: Unique identifier for the WhatsApp Business Account
    - `name` string, 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_number` string: Purchase order number associated with the account
    - `audiences` string[]: List of audience segments associated with the account
    - `ownership_type` 'SELF_OWNED' | 'CLIENT_OWNED' | 'AGENCY_OWNED': Type of ownership for the WhatsApp Business Account
    - `subscribed_apps` SubscribedApp[]: List of applications subscribed to this WABA
      - `id` string: Application ID
      - `name` string: Application name
    - `business_verification_status` 'VERIFIED' | 'UNVERIFIED' | 'PENDING' | 'REJECTED': Verification status of the connected client business
    - `country` string: Country code where the WABA is registered
    - `currency` string: Currency code for the WABA
    - `timezone_id` string: Timezone identifier for the WABA
    - `on_behalf_of_business_info` OnBehalfOfBusinessInfo: Information about the business on whose behalf the WABA operates
      - `id` string: Business ID
      - `name` string: Business name
    - `schedules` BusinessSchedule[]: Business hours and scheduling information
      - `day_of_week` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY'
      - `open_time` string: Opening time in HH:MM format
      - `close_time` string: Closing time in HH:MM format
    - `is_enabled_for_insights` boolean: Whether insights are enabled for this WABA
    - `dcc_config` DCCConfig: Data and Content Control configuration
      - `enabled` boolean: Whether DCC is enabled
      - `policy_url` string: URL to the DCC policy
    - `message_templates` MessageTemplate[]: Message templates associated with the WABA
      - `id` string: Template ID
      - `name` string: Template name
      - `status` 'APPROVED' | 'PENDING' | 'REJECTED' | 'DISABLED'
    - `phone_numbers` PhoneNumber[]: Phone numbers associated with the WABA
      - `id` string: Phone number ID
      - `display_phone_number` string: Formatted phone number for display
      - `verified_name` string: Verified business name for the phone number
  - `paging` CursorPaging: Cursor-based pagination information
    - `cursors` object
      - `before` string: Cursor pointing to the start of the page of data
      - `after` string: Cursor pointing to the end of the page of data
    - `previous` string: URL for the previous page of results
    - `next` string: URL for the next page of results

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Business ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)