---
title: "List WhatsApp groups"
method: GET
path: "/whatsapp/wa-group/list"
---

# List WhatsApp groups

`GET /whatsapp/wa-group/list`

Returns a paginated list of WhatsApp groups for the given WABA number. Uses cursor-based pagination — pass `lastGroupId` and `olderThanTimestamp` from the previous response to fetch the next page.

## Query parameters

- `wabaNumber` string, required
- `lastGroupId` string
- `olderThanTimestamp` string, date-time

## Response `200`

Paginated list of groups

- ListGroupsResponse
  - `groups` GroupListItem[]
    - `groupId` string — Unique identifier for the group
    - `subject` string — Group name/subject
    - `description` string — Group description
    - `totalParticipantCount` integer — Current number of participants in the group
    - `inviteLink` string, nullable — WhatsApp invite link for the group
    - `status` string — Current group status (e.g. ACTIVE)
    - `groupCreatedAt` string, date-time — ISO 8601 timestamp of when the group was created
  - `hasMore` boolean — Whether more pages are available
  - `lastGroupId` string, nullable — Cursor — pass as lastGroupId in the next request to fetch the next page
  - `olderThanTimestamp` string, date-time, nullable — Cursor timestamp — pass in the next request along with lastGroupId to fetch the next page

## Other responses

- `400` — Missing wabaNumber or no integration found for the given WABA number

---

[API](https://skmtc.net/doubletick/apis/doubletick-public-apis.md) · [All operations](https://skmtc.net/doubletick/apis/doubletick-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/doubletick/doubletick-public-apis/versions/bba484527d34/schema)