Listar Usuarios da Conta

Retorna a lista paginada de membros de uma organizacao.

Requisicao

GET /v1/organizations/{orgId}/members

Headers

Header	Tipo	Obrigatorio	Descricao
Authorization	string	Sim	Bearer token de autenticacao

Parametros de URL

Parametro	Tipo	Obrigatorio	Descricao
orgId	string	Sim	Identificador unico da organizacao

Parametros de Query

Parametro	Tipo	Obrigatorio	Padrao	Descricao
page	number	Nao	0	Numero da pagina (comeca em 0)
size	number	Nao	20	Quantidade de itens por pagina

Exemplo de requisicao

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

Resposta

200 - Sucesso

{
  "content": [
    {
      "id": "usr_1a2b3c4d",
      "name": "Maria Silva",
      "email": "maria@empresa.com.br",
      "role": "OWNER",
      "joinedAt": "2025-08-10T14:30:00Z"
    },
    {
      "id": "usr_5e6f7g8h",
      "name": "Joao Santos",
      "email": "joao@empresa.com.br",
      "role": "ADMIN",
      "joinedAt": "2025-09-22T09:15:00Z"
    },
    {
      "id": "usr_9i0j1k2l",
      "name": "Ana Oliveira",
      "email": "ana@empresa.com.br",
      "role": "MEMBER",
      "joinedAt": "2026-01-05T16:45:00Z"
    }
  ],
  "page": 0,
  "size": 20,
  "totalElements": 3,
  "totalPages": 1
}

Campos da resposta

Campo	Tipo	Descricao
content	array	Lista de membros da organizacao
content[].id	string	Identificador unico do usuario
content[].name	string	Nome completo do usuario
content[].email	string	Email do usuario
content[].role	string	Papel na organizacao (OWNER, ADMIN, MEMBER)
content[].joinedAt	string	Data de ingresso na organizacao (ISO 8601)
page	number	Pagina atual
size	number	Tamanho da pagina
totalElements	number	Total de membros na organizacao
totalPages	number	Total de paginas disponiveis

Papeis disponiveis

• OWNER: Proprietario da organizacao. Acesso total, incluindo gerenciamento de plano e cobranca.
• ADMIN: Administrador. Pode gerenciar membros e configuracoes da organizacao.
• MEMBER: Membro padrao. Pode criar e gerenciar seus proprios documentos.

401 - Nao autorizado

{
  "error": "UNAUTHORIZED",
  "message": "Token de autenticacao invalido ou expirado."
}

403 - Acesso negado

{
  "error": "FORBIDDEN",
  "message": "Voce nao tem permissao para listar membros desta organizacao."
}

Atencao

Somente usuarios com papel OWNER ou ADMIN podem listar os membros da organizacao.