Listar Usuários da Conta

Retorna, com paginação, os membros ativos de uma organização. Para convidar, remover ou alterar o papel de membros, veja Gerenciar Membros.

Requisição

GET /v1/organizations/{orgId}/members

Headers

Header	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Bearer {token}

Parâmetros de URL

Parâmetro	Tipo	Obrigatório	Descrição
orgId	integer	Sim	ID da organização (obtido em Listar Organizações)

Parâmetros de Query

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
page	number	Não	0	Número da página (começa em 0)
size	number	Não	20	Itens por página. Valores acima de 200 são reduzidos para 200

Exemplo de requisição

curl -X GET \
  "https://api.tapsign.com.br/v1/organizations/42/members?page=0&size=20" \
  -H "Authorization: Bearer {token}"

Resposta

200 - Sucesso

{
  "content": [
    {
      "id": 7,
      "userId": 1001,
      "userName": "Maria Silva",
      "userEmail": "[email protected]",
      "userImgUrl": null,
      "role": "OWNER",
      "active": true,
      "joinedAt": "2026-08-10T14:30:00Z"
    },
    {
      "id": 8,
      "userId": 1002,
      "userName": "Joao Santos",
      "userEmail": "[email protected]",
      "userImgUrl": null,
      "role": "ADMIN",
      "active": true,
      "joinedAt": "2026-08-22T09:15:00Z"
    },
    {
      "id": 9,
      "userId": 1003,
      "userName": "Ana Oliveira",
      "userEmail": "[email protected]",
      "userImgUrl": null,
      "role": "MEMBER",
      "active": true,
      "joinedAt": "2026-09-05T16:45:00Z"
    }
  ],
  "totalElements": 3,
  "totalPages": 1,
  "size": 20,
  "number": 0
}

Campos da resposta

Campo	Tipo	Descrição
content	array	Membros ativos da organização
content[].id	number	ID do membro na organização (usado nas rotas de membros; não é o userId)
content[].userId	number	ID do usuário
content[].userName	string	Nome do usuário
content[].userEmail	string	E-mail do usuário
content[].userImgUrl	string | null	URL da foto do usuário
content[].role	string	Papel na organização: OWNER, ADMIN, MEMBER ou VIEWER
content[].active	boolean	Se o membro está ativo
content[].joinedAt	string	Data de ingresso na organização (ISO 8601, UTC)
totalElements	number	Total de membros ativos
totalPages	number	Total de páginas
size	number	Tamanho da página
number	number	Página atual (começa em 0)

Papéis

• OWNER: proprietário da organização. Passa em todas as checagens de permissão.
• ADMIN: administrador. Por padrão tem todas as permissões do catálogo.
• MEMBER: membro. Por padrão cria, edita e envia documentos e modelos.
• VIEWER: leitor. Por padrão só tem permissões de leitura.

Detalhes em Papéis e Permissões.

401 - Não autorizado

Token ausente, inválido ou chave de API desativada.

403 - Acesso negado

O usuário não é membro ativo da organização ou teve a permissão MEMBERS:READ retirada individualmente.

Quem pode listar

Todos os papéis padrão (OWNER, ADMIN, MEMBER e VIEWER) têm a permissão MEMBERS:READ. O formato do corpo de erro está em Status de Erros.