---
title: "Get Assigned WhatsApp Business Accounts"
method: GET
path: "/{Version}/{User-ID}/assigned_whatsapp_business_accounts"
tags: ["Assigned WhatsApp Business Accounts"]
---

# Get Assigned WhatsApp Business Accounts

`GET /{Version}/{User-ID}/assigned_whatsapp_business_accounts`

## Request

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

Retrieve WhatsApp Business Accounts that have been assigned to a specific user.
This endpoint provides information about account assignments, permissions, and
current status corresponding to the GraphAssignedWhatsAppBusinessAccountsEdge node.


**Use Cases:**
- Retrieve all WhatsApp Business Accounts assigned to a user
- Check user permissions for specific accounts
- Monitor account assignment status and changes
- Validate user access before performing business operations


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


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

## Path parameters

- `Version` string, required
- `User-ID` string, required

## Query parameters

- `fields` string
- `limit` integer
- `after` string
- `before` string

## Headers

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

## Response `200`

Successfully retrieved assigned WhatsApp Business Accounts

- AssignedAccountsResponse: Response containing assigned WhatsApp Business Accounts
  - `data` AssignedWhatsAppBusinessAccount[], required: List of assigned WhatsApp Business Accounts
    - `id` string, required: Unique identifier for the WhatsApp Business Account
    - `name` string, required: Display name of the WhatsApp Business Account
    - `status` 'ACTIVE' | 'PENDING' | 'RESTRICTED' | 'DISABLED', required: Current status of the WhatsApp Business Account
    - `assignment_date` string, date-time: Date and time when the account was assigned to the user
    - `permissions` WhatsAppBusinessAccountPermission[]: List of permissions granted to the user for this account
    - `business_id` string: Business ID that owns this WhatsApp Business Account
    - `phone_numbers` PhoneNumberInfo[]: Phone numbers associated with this WhatsApp Business Account
      - `id` string: The ID associated with the phone number
      - `display_phone_number` string: The string representation of the phone number
      - `verified_name` string: The verified name associated with the phone number
      - `quality_rating` 'GREEN' | 'YELLOW' | 'RED' | 'NA': The quality rating of the phone number based on how messages have been received by recipients in recent days. - GREEN: High Quality - YELLOW: Medium Quality - RED: Low Quality - NA: Quality has not been determined
      - `code_verification_status` 'VERIFIED' | 'UNVERIFIED': The two-step verification status for the phone number indicating whether the number has completed two-step verification. - VERIFIED: Phone number has completed two-step verification - UNVERIFIED: Two-step verification is pending or incomplete
      - `name_status` 'APPROVED' | 'AVAILABLE_WITHOUT_REVIEW' | 'DECLINED' | 'EXPIRED' | 'PENDING_REVIEW' | 'NONE': The status of a display name associated with a specific phone number. - APPROVED: The display name has been approved and is ready to use. - AVAILABLE_WITHOUT_REVIEW: The display name is ready to use without review. - DECLINED: The display name has not been approved. - EXPIRED: The display name approval has expired. - PENDING_REVIEW: The display name is under review. - NONE: No display name verification request exists.
  - `paging` PagingInfo
    - `cursors` object
      - `before` string: Before cursor
      - `after` string: After cursor
    - `previous` string: Previous page URL
    - `next` string: Next page URL

## 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 - User 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)