# Listar todos os grupos

`GET /group/list`

Pasta: **Grupos e Comunidades**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Listar todos os grupos

Retorna os grupos em que a instância participa. Use para sincronizar inventário de grupos ou montar painéis administrativos.

## Endpoint

`GET {{baseUrl}}/group/list`

## Autenticação

Envie o token da instância no header:

`token: {{token}}`

## Corpo da requisição

Esta rota é `GET` e **não possui corpo nem query params**. O handler chama `GetJoinedGroups` diretamente.

## Exemplo de Requisição

```bash
curl -X GET "{{baseUrl}}/group/list" \
  -H "token: {{token}}"
```

## Resposta de Sucesso

```json
{
  "success": true,
  "groups": [
    {
      "JID": "120363324255083289@g.us",
      "Name": "Equipe Comercial",
      "Topic": "Grupo oficial",
      "GroupCreated": "2026-01-10T15:00:00Z",
      "IsAnnounce": false,
      "IsLocked": true,
      "Participants": []
    }
  ]
}
```

## Erros comuns

- Instância desconectada ou token inválido.
- Contas com muitos grupos podem demorar mais para responder.
- Somente grupos acessíveis pela instância são retornados.

## Observações

- A resposta pode incluir comunidades e grupos vinculados, conforme o WhatsApp.

## cURL

```bash
curl -X GET "{{baseUrl}}/group/list" \
  -H "token: {{token}}"
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=grupos-e-comunidades/listar-todos-os-grupos)