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

# List Groups

> Get all WhatsApp groups you're a member of

Retrieve a list of all WhatsApp groups where you are a participant.

## Response Fields

<ResponseField name="data.groups" type="array">
  Array of group objects with full details
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.livchat.ai/v1/groups/list \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.livchat.ai/v1/groups/list", {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  });

  const { data } = await response.json();
  console.log(`Found ${data.groups.length} groups`);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "code": 200,
    "data": {
      "groups": [
        {
          "jid": "120362023605733675@g.us",
          "name": "Team Chat",
          "ownerJid": "5511999999999@s.whatsapp.net",
          "groupCreated": "2024-01-15T10:30:00-03:00",
          "isAnnounce": false,
          "isLocked": false,
          "isEphemeral": false,
          "disappearingTimer": 0,
          "participants": [
            {
              "jid": "5511999999999@s.whatsapp.net",
              "isAdmin": true,
              "isSuperAdmin": true
            },
            {
              "jid": "5511888888888@s.whatsapp.net",
              "isAdmin": false,
              "isSuperAdmin": false
            }
          ]
        }
      ]
    }
  }
  ```
</ResponseExample>