---
title: "List groups"
method: GET
path: "/whatsapp/{businessPhoneNumber}/groups"
tags: ["WhatsApp Groups"]
---

# List groups

`GET /whatsapp/{businessPhoneNumber}/groups`

Returns a cursor-paginated list of active WhatsApp groups.

## Path parameters

- `businessPhoneNumber` string, required

## Query parameters

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

## Response `200`

Successfully retrieved groups.

- WhatsappGroupListResponse — Cursor-paginated WhatsApp group list response.
  - `data` WhatsappGroupListItem[]
    - `groupId` string — WhatsApp group ID.
    - `subject` string — The group subject.
    - `createdAt` integer — Unix timestamp indicating when the group 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)