---
title: "List group join requests"
method: GET
path: "/whatsapp/{businessPhoneNumber}/groups/{groupId}/joinRequests"
tags: ["WhatsApp Groups"]
---

# List group join requests

`GET /whatsapp/{businessPhoneNumber}/groups/{groupId}/joinRequests`

Returns a cursor-paginated list of pending join requests for a WhatsApp group.

## Path parameters

- `businessPhoneNumber` string, required
- `groupId` string, required

## Query parameters

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

## Response `200`

Successfully retrieved group join requests.

- WhatsappGroupJoinRequestListResponse — Cursor-paginated WhatsApp group join request response.
  - `data` WhatsappGroupJoinRequest[]
    - `joinRequestId` string — The join request ID.
    - `waId` string — WhatsApp user ID.
    - `userId` string — Business-scoped user ID.
    - `parentUserId` string — Parent business-scoped user ID.
    - `username` string — WhatsApp username.
    - `creationTimestamp` integer — Unix timestamp indicating when the join request was created.
  - `paging` WhatsappGroupPaging — Cursor pagination information.
    - `before` string — Cursor for the previous page.
    - `after` string — Cursor for the next page.

## Other responses

- `400` — Bad request. Invalid request parameters.

---

[API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)