---
title: "List Assigned Users"
method: GET
path: "/{Version}/{WhatsApp-Business-Account-ID}/assigned_users"
tags: ["WhatsApp Business Account Users"]
---

# List Assigned Users

`GET /{Version}/{WhatsApp-Business-Account-ID}/assigned_users`

## Request

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

Retrieve a list of users assigned to the WhatsApp Business Account with their permissions
and user details. This endpoint supports pagination and filtering capabilities.


**Use Cases:**
- Audit user access to WhatsApp Business Account
- Retrieve user permission assignments for compliance
- List all users with access for management purposes
- Monitor user access patterns and assignments


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


**Caching:**
User assignment data can be cached for short periods, but permission changes may occur
frequently. Implement appropriate cache invalidation strategies.

## Path parameters

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

## Query parameters

- `business` string, required
- `fields` string
- `limit` integer
- `after` string
- `before` string

## Headers

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

## Response `200`

Successfully retrieved assigned users list

- AssignedUsersResponse: Response containing list of assigned users with pagination
  - `data` AssignedUser[], required: Array of assigned users
    - `id` string, required: Unique identifier for the assigned user
    - `name` string, required: Display name of the assigned user
    - `business` BusinessNode: Business entity associated with the user
      - `id` string: Unique identifier for the business
      - `name` string: Name of the business
    - `user_type` 'BUSINESS_USER' | 'SYSTEM_USER' | 'PERSONAL_USER': Type of user assignment
  - `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
  - `summary` AssignedUsersSummary: Summary information about assigned users
    - `total_count` integer: Total number of assigned users

## 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 - WhatsApp Business Account 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)