---
title: "Fetch All Groups"
method: GET
path: "/group/fetchAllGroups/{instance}"
tags: ["Group Controller"]
---

# Fetch All Groups

`GET /group/fetchAllGroups/{instance}`

Fetch all groups

## Path parameters

- `instance` string, required

## Query parameters

- `getParticipants` boolean, required

## Response `200`

Ok

- object[] — Array of objects representing WhatsApp group details.
  - `id` string, required — The ID of the group.
  - `subject` string, required — The subject (name) of the group.
  - `subjectOwner` string, required — The ID of the user who set the subject.
  - `subjectTime` integer, required — The timestamp when the subject was set.
  - `pictureUrl` string — URL of the group's profile picture.
  - `size` integer, required — The number of participants in the group.
  - `creation` integer, required — The timestamp when the group was created.
  - `owner` string, required — The ID of the group owner.
  - `desc` string — The description of the group.
  - `descId` string — The ID of the description message.
  - `restrict` boolean, required — Indicates if the group is restricted (only admins can send messages).
  - `announce` boolean, required — Indicates if the group is an announcement group (only admins can send messages).

## Changes

- **2024-10-14** (v2) `c153448703e5` — 1 breaking, 4 info
  - the `query` request parameter `getParticipants` became required
  - api operation id `fetchAllGroups` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Group Controller` added
  - …1 more
- **2024-09-09** (v2) `0c4620ca5ed5` — 5 info
  - api operation id `fetchAllGroups` removed and replaced with ``
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - api tag `Group` added
  - api tag `Group Controller` removed
  - …1 more

[Change history](https://skmtc.dev/evolution-foundation/apis/openapi/changes/group/fetchAllGroups/:instance/get.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/openapi.md) · [All operations](https://skmtc.dev/evolution-foundation/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolution-foundation/openapi/revisions/153363ee7f38/schema)