# Obtenha uma lista de grupos

Lista os grupos de perfis, página por página.
- **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado.
- **Observação**: quando a equipe autoriza o acesso por grupo, um membro que não tem nenhuma concessão de grupo recebe uma página vazia em vez de um erro.

Endpoint: POST /envgroup/page
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `groupName` (string, required)

  - `pageNo` (integer, required)

  - `pageSize` (integer, required)

## Response 200:

  - `200` (unknown)
    Sucesso. `data.dataList` contém os registros da página solicitada e é um array vazio quando não há correspondências; `data.total`, `data.current` e `data.pages` descrevem a paginação.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado. `0` indica sucesso; outros códigos indicam exceções.

  - `msg` (string | null, required)
    Mensagem de erro

  - `data` (object, required)

  - `data.current` (string, required)

  - `data.dataList` (array, required)

  - `data.dataList.id` (string)
    ID do grupo

  - `data.dataList.groupName` (string)
    Nome do grupo

  - `data.pages` (string, required)

  - `data.total` (string, required)

  - `requestId` (string, required)
    ID da solicitação da operação