> ## Documentation Index > Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt > Use this file to discover all available pages before exploring further. # List WhatsApp groups > List groups on this WhatsApp connection. ## OpenAPI ````yaml /en/whatsapp-api/api-reference/openapi-whatsapp.json get /v1/whatsapp/instances/{instanceId}/groups openapi: 3.0.3 info: title: Notifique API — WhatsApp description: >- Send WhatsApp messages and manage connections. Authenticate with `Authorization: Bearer sk_live_...` or `x-api-key`. version: 1.0.0 servers: - url: https://api.notifique.dev description: Production security: - ntfWaBearerAuth: [] - ntfWaApiKeyHeader: [] tags: - name: Messages description: Send, list, edit, and cancel messages - name: Instances description: >- Register and manage connected WhatsApp numbers — each number is an **instance** (the phone that sends and receives messages). - name: Groups description: Groups (unofficial only) - name: Calls description: Call and speak on WhatsApp (unofficial today; official soon) - name: Sending pools description: Balanceamento de instâncias WhatsApp paths: /v1/whatsapp/instances/{instanceId}/groups: get: tags: - Grupos summary: List WhatsApp groups description: List groups on this WhatsApp connection. operationId: ntfWa_getV1WhatsappInstancesInstanceIdGroups parameters: - name: instanceId in: path required: true schema: type: string description: ID da instance no workspace. - name: page in: query required: false schema: type: integer default: 1 description: Página da listagem (a partir de 1). - name: limit in: query required: false schema: type: integer default: 20 maximum: 100 description: Quantidade por página (máx. 100). responses: '200': description: >- List de grupos (paginada) ou indicação de que a lista está sendo carregada. content: application/json: schema: $ref: >- #/components/schemas/ntfWa_GetV1WhatsappInstancesInstanceIdGroupsResponse examples: withData: summary: Sucesso — dados em cache (paginado) value: success: true data: - id: 120363295648424210@g.us name: Meu Grupo participantsCount: 5 owner: 5511999999999@s.whatsapp.net creation: 1699000000 pagination: page: 1 limit: 20 total: 5 loading: summary: Carregando — tentar novamente em breve value: success: true loading: true message: >- Lista de grupos está sendo carregada. Tente novamente em alguns segundos. data: [] pagination: page: 1 limit: 20 total: 0 '401': description: Missing or invalid API Key. content: application/json: schema: $ref: '#/components/schemas/NtfWa_ErrorResponse' example: success: false error: Bad Request code: VALIDATION_ERROR message: Campo inválido ou ausente. '402': description: Plano expirado ou suspenso. content: application/json: schema: $ref: '#/components/schemas/NtfWa_ErrorResponse' example: success: false error: Bad Request code: VALIDATION_ERROR message: Campo inválido ou ausente. '403': description: >- Escopo whatsapp:groups ausente ou instance official (WHATSAPP_GROUPS_UNOFFICIAL_ONLY). content: application/json: schema: $ref: '#/components/schemas/NtfWa_ErrorResponse' example: success: false error: Bad Request code: VALIDATION_ERROR message: Campo inválido ou ausente. '404': description: Instance not found. content: application/json: schema: $ref: '#/components/schemas/NtfWa_ErrorResponse' example: success: false error: Bad Request code: VALIDATION_ERROR message: Campo inválido ou ausente. '502': description: Erro ao processar requisição. content: application/json: schema: $ref: '#/components/schemas/NtfWa_ErrorResponse' components: schemas: ntfWa_GetV1WhatsappInstancesInstanceIdGroupsResponse: type: object properties: success: type: boolean example: true loading: type: boolean description: >- Quando true, a lista ainda está sendo obtida; data virá vazio — tente novamente em alguns segundos. message: type: string description: Message quando loading é true. data: type: array items: type: object properties: id: type: string description: 'JID do grupo (ex.: 120363295648424210@g.us)' name: type: string participantsCount: type: integer owner: type: string creation: type: integer pagination: type: object properties: page: type: integer limit: type: integer total: type: integer example: success: true loading: true message: string data: - id: clxx... name: Exemplo participantsCount: 1 owner: string creation: 1 pagination: page: 1 limit: 1 total: 1 NtfWa_ErrorResponse: type: object properties: success: type: boolean example: false error: type: string description: 'Rótulo HTTP do erro (ex.: Unauthorized, Bad Request, Not Found).' message: type: string description: >- Message legível para exibir ao usuário (localizada via Accept-Language / x-locale quando aplicável). code: type: string description: >- Código estável da API v1 (enum). Sempre presente em erros. Use com o status HTTP para decidir retry ou correção. Ver [Responses de erro](/guides/conceitos/resposta-de-erros). details: type: array items: type: object properties: field: type: string message: type: string note: type: string required: - success - error - message - code example: success: false error: string message: string code: string details: - field: string message: string note: string securitySchemes: ntfWaBearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- API Key no header Authorization. Exemplo: `Authorization: Bearer sk_live_xxxxx` ntfWaApiKeyHeader: type: apiKey in: header name: x-api-key description: API Key no header x-api-key. ````