> For the complete documentation index, see [llms.txt](https://docs.astraapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.astraapi.com/integrando/grupos/listar-grupos.md).

# Listar grupos

<mark style="color:blue;">`GET`</mark> `https://api.astraapi.com/api/group/{{instanceId}}`

#### Path Parameters

| Name                                         | Type   | Description         |
| -------------------------------------------- | ------ | ------------------- |
| instanceId<mark style="color:red;">\*</mark> | Number | id da sua instancia |

#### Headers

| Name          | Type   | Description            |
| ------------- | ------ | ---------------------- |
| Authorization | String | Seu token de segurança |

{% tabs %}
{% tab title="200: OK Lista de grupos" %}

```json
[
    {
        "chatId": "120363029431518951@g.us",
        "chatName": "grupoo",
        "unreadCount": 12,// quantidade de mensagens não lidas
        "unreadMentionCount": 0// quantidade de mensagens de marcação não lidas
    },
    {
        "chatId": "120363029431518951@g.us",
        "chatName": "GRUPO TESTE",
        "unreadCount": 0,
        "unreadMentionCount": 0
    }
]
```

{% endtab %}
{% endtabs %}