---
title: "List WhatsApp groups"
method: GET
path: "/v1/connections/{connection}/groups"
tags: ["Connections"]
---

# List WhatsApp groups

`GET /v1/connections/{connection}/groups`

## Request

- Base URL: `https://www.chatrail.dev`
- URL: `https://www.chatrail.dev/v1/connections/{connection}/groups`
- Auth: HTTP bearer

Returns a bounded, name-sorted page for a group picker. Group ids use the same `from.group` representation delivered in message webhooks. Participant identities are never returned.

## Path parameters

- `connection` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

A page of groups.

## Other responses

- `404`: No such connection.
- `502`: The transport returned an unreadable response.
- `503`: The transport is unavailable.

---

[API](https://skmtc.dev/chatrail/apis/chatrail-api.md) · [All operations](https://skmtc.dev/chatrail/apis/chatrail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatrail/apis/chatrail-api/revisions/acc5b88c6f59?raw)