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

# List WhatsApp groups

`GET /whatsapp/wa-group/list`

## Request

- Base URL: `https://public.doubletick.io`
- URL: `https://public.doubletick.io/whatsapp/wa-group/list`
- Auth: none declared
- TypeScript: <https://skmtc.dev/doubletick/apis/doubletick-public-apis/docs/whatsapp/wa-group/list/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/doubletick/apis/doubletick-public-apis.md) - [All operations](https://skmtc.dev/doubletick/apis/doubletick-public-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/doubletick/apis/doubletick-public-apis/revisions/bba484527d34?raw)