> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Grupos

> Lista todos os grupos da sessão

Retorna uma lista de todos os grupos dos quais a sessão participa.

## Query Parameters

<ParamField query="sessionId" type="string" required>
  ID da sessão.
</ParamField>

## Resposta

<ResponseField name="success" type="boolean">
  Se a operação foi bem-sucedida.
</ResponseField>

<ResponseField name="groups" type="array">
  Lista de grupos.

  <Expandable title="Objeto Group">
    <ResponseField name="id" type="string">
      JID do grupo.
    </ResponseField>

    <ResponseField name="subject" type="string">
      Nome do grupo.
    </ResponseField>

    <ResponseField name="subjectTime" type="number">
      Timestamp da última alteração do nome.
    </ResponseField>

    <ResponseField name="creation" type="number">
      Timestamp de criação.
    </ResponseField>

    <ResponseField name="owner" type="string">
      JID do criador.
    </ResponseField>

    <ResponseField name="size" type="number">
      Número de participantes.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X GET "https://api.oxenty.api.br/api/groups/list?sessionId=550e8400-e29b-41d4-a716-446655440000" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={"system"}
  const groups = await client.groups.list(sessionId);

  for (const group of groups.groups) {
    console.log(`${group.subject} (${group.size} membros)`);
  }
  ```

  ```python Python theme={"system"}
  groups = client.groups.list(session_id)

  for group in groups['groups']:
      print(f"{group['subject']} ({group['size']} membros)")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "success": true,
    "groups": [
      {
        "id": "120363123456789012@g.us",
        "subject": "Equipe de Vendas",
        "subjectTime": 1705315200,
        "creation": 1705315200,
        "owner": "5511777777777@s.whatsapp.net",
        "size": 15
      },
      {
        "id": "120363098765432109@g.us",
        "subject": "Suporte Técnico",
        "subjectTime": 1705228800,
        "creation": 1704969600,
        "owner": "5511888888888@s.whatsapp.net",
        "size": 8
      }
    ]
  }
  ```
</ResponseExample>