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

# Listar grupos dos quais participa

> Retorna todos os grupos dos quais o número conectado participa.



## OpenAPI

````yaml openapi.evolution-go.pt.json GET /group/list
openapi: 3.1.0
info:
  title: Evolution GO Layer
  version: 1.0.0
  description: >-
    Camada de API do Pilot Status — Evolution GO. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-go`. Autentique com o header
    `apikey` (sua chave `ps_` do Pilot Status) ou `Authorization: Bearer`.
    Endpoints de instância/sessão NÃO estão disponíveis na camada.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-go
security:
  - apiKey: []
tags:
  - name: Chamada (voz)
  - name: Chat
  - name: Comunidade
  - name: Grupo
  - name: Etiqueta (label)
  - name: Mensagem
  - name: Newsletter / Canais
  - name: Envio (balanceado)
  - name: Usuário / Contatos
paths:
  /group/list:
    get:
      tags:
        - Grupo
      summary: Listar grupos dos quais participa
      description: Retorna todos os grupos dos quais o número conectado participa.
      operationId: get__group_list
      responses:
        '200':
          description: Sucesso — corpo de resposta nativo do provedor.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Envelope returned by the Evolution GO layer for List joined
                  groups. `data` is the raw whatsmeow []types.GroupInfo array
                  (fields are PascalCase; embedded structs are flattened; JIDs
                  are serialized as strings).
                properties:
                  message:
                    type: string
                    description: Always "success" on HTTP 200.
                  data:
                    type: array
                    description: All groups the connected number has joined.
                    items:
                      type: object
                      properties:
                        JID:
                          type: string
                          description: Group JID.
                        OwnerJID:
                          type: string
                          description: JID of the group creator/owner.
                        OwnerPN:
                          type: string
                          description: Phone-number JID of the owner.
                        Name:
                          type: string
                          description: Group subject/name.
                        NameSetAt:
                          type: string
                          format: date-time
                          description: When the name was last set.
                        NameSetBy:
                          type: string
                          description: JID that last set the name.
                        NameSetByPN:
                          type: string
                          description: Phone-number JID that last set the name.
                        Topic:
                          type: string
                          description: Group description/topic.
                        TopicID:
                          type: string
                        TopicSetAt:
                          type: string
                          format: date-time
                        TopicSetBy:
                          type: string
                        TopicSetByPN:
                          type: string
                        TopicDeleted:
                          type: boolean
                        IsLocked:
                          type: boolean
                          description: Only admins can edit group info.
                        IsAnnounce:
                          type: boolean
                          description: Only admins can send messages.
                        AnnounceVersionID:
                          type: string
                        IsEphemeral:
                          type: boolean
                          description: Disappearing messages enabled.
                        DisappearingTimer:
                          type: integer
                          description: Disappearing-messages timer in seconds.
                        IsIncognito:
                          type: boolean
                        IsParent:
                          type: boolean
                          description: Whether this is a community parent group.
                        DefaultMembershipApprovalMode:
                          type: string
                        LinkedParentJID:
                          type: string
                          description: >-
                            Parent community JID if this is a sub-group (empty
                            string otherwise).
                        IsDefaultSubGroup:
                          type: boolean
                        IsJoinApprovalRequired:
                          type: boolean
                        AddressingMode:
                          type: string
                          description: 'Addressing mode: "pn" (phone number) or "lid".'
                        GroupCreated:
                          type: string
                          format: date-time
                          description: Group creation timestamp.
                        CreatorCountryCode:
                          type: string
                        ParticipantVersionID:
                          type: string
                        Participants:
                          type: array
                          items:
                            type: object
                            properties:
                              JID:
                                type: string
                                description: Primary JID used to message this participant.
                              PhoneNumber:
                                type: string
                              LID:
                                type: string
                              IsAdmin:
                                type: boolean
                              IsSuperAdmin:
                                type: boolean
                              DisplayName:
                                type: string
                                description: >-
                                  Only set for anonymous users in announcement
                                  groups.
                              Error:
                                type: integer
                                description: >-
                                  Error code if adding this participant failed
                                  (0 = success).
                              AddRequest:
                                type:
                                  - object
                                  - 'null'
                                properties:
                                  Code:
                                    type: string
                                  Expiration:
                                    type: string
                                    format: date-time
                        ParticipantCount:
                          type: integer
                        MemberAddMode:
                          type: string
                          description: >-
                            Who can add members: "admin_add" or
                            "all_member_add".
                        Suspended:
                          type: boolean
                          description: Whether the group is currently suspended.
              example:
                message: success
                data:
                  - JID: 120363012345678901@g.us
                    OwnerJID: 5511999999999@s.whatsapp.net
                    OwnerPN: 5511999999999@s.whatsapp.net
                    Name: Equipe Pilot Status
                    NameSetAt: '2026-07-01T14:22:31Z'
                    NameSetBy: 5511999999999@s.whatsapp.net
                    NameSetByPN: 5511999999999@s.whatsapp.net
                    Topic: Grupo oficial de suporte
                    TopicID: 1719849751-1
                    TopicSetAt: '2026-07-01T14:25:10Z'
                    TopicSetBy: 5511999999999@s.whatsapp.net
                    TopicSetByPN: 5511999999999@s.whatsapp.net
                    TopicDeleted: false
                    IsLocked: false
                    IsAnnounce: false
                    AnnounceVersionID: ''
                    IsEphemeral: false
                    DisappearingTimer: 0
                    IsIncognito: false
                    IsParent: false
                    DefaultMembershipApprovalMode: ''
                    LinkedParentJID: ''
                    IsDefaultSubGroup: false
                    IsJoinApprovalRequired: false
                    AddressingMode: pn
                    GroupCreated: '2026-07-01T14:22:31Z'
                    CreatorCountryCode: BR
                    ParticipantVersionID: '1719849751'
                    Participants:
                      - JID: 5511999999999@s.whatsapp.net
                        PhoneNumber: 5511999999999@s.whatsapp.net
                        LID: 199999999999999@lid
                        IsAdmin: true
                        IsSuperAdmin: true
                        DisplayName: ''
                        Error: 0
                        AddRequest: null
                      - JID: 5511988888888@s.whatsapp.net
                        PhoneNumber: 5511988888888@s.whatsapp.net
                        LID: 198888888888888@lid
                        IsAdmin: false
                        IsSuperAdmin: false
                        DisplayName: ''
                        Error: 0
                        AddRequest: null
                    ParticipantCount: 2
                    MemberAddMode: all_member_add
                    Suspended: false
        default:
          description: Erro — erro do provedor ou da camada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                  response:
                    type: object
              example:
                status: 400
                error: Bad Request
                message: Invalid payload
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Your Pilot Status API key (ps_...). Evolution GO also accepts
        `Authorization: Bearer <key>`.

````