---
title: "List WhatsApp group conversations"
method: GET
path: "/v2/groups"
tags: ["WhatsApp Groups"]
---

# List WhatsApp group conversations

`GET /v2/groups`

## Request

- Base URL: `https://api.spurnow.com`
- URL: `https://api.spurnow.com/v2/groups`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` number
- `subject` string

## Response `200`

- GroupConversationListResponseDto
  - `groups` GroupConversationDto[], required
    - `id` number, required
    - `metaGroupId` string, nullable, required
    - `channelId` number, required
    - `requestId` string, nullable, required
    - `subject` string, nullable, required
    - `description` string, nullable, required
    - `notes` string, nullable, required: Internal group-level notes used as AI context. Never sent to WhatsApp.
    - `inviteLink` string, nullable, required
    - `profilePictureUrl` string, nullable, required: S3 URL of the group icon Meta accepted. Rendered by the UI; Meta stores its own copy for delivery to WhatsApp. Null if never set or if a subsequent update was rejected by Meta.
    - `lifecycleStatus` 'creating' | 'active' | 'suspended' | 'deleted', required
    - `conversationStatus` 'OPEN' | 'CLOSED', required
    - `assignedAgentId` number, nullable, required
    - `assignedTeamId` number, nullable, required
    - `lastMessageAt` string, date-time, nullable, required
    - `agentLastSeenAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `hasMore` boolean, required
  - `cursor` string, nullable, required

---

[API](https://skmtc.dev/spurnow/apis/spur-apis.md) - [All operations](https://skmtc.dev/spurnow/apis/spur-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/spurnow/apis/spur-apis/revisions/27ca7bf002cb?raw)