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

# Fetch All Groups

`GET /group/fetchAllGroups/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/group/fetchAllGroups/{instance}`
- Auth: API key in header `apikey`

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-11-25** (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

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

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)