Pular para o conteúdo principal

Listar Organizacoes

Retorna todas as organizacoes das quais o usuario autenticado e membro.

Requisicao

GET /v1/organizations

URL completa: https://api.tapsign.com.br/v1/organizations

Headers

HeaderValor
AuthorizationBearer {token}

Exemplo de requisicao

curl -X GET https://api.tapsign.com.br/v1/organizations \
-H "Authorization: Bearer {token}"

Resposta

Status: 200 OK

{
"content": [
{
"id": "org_abc123",
"name": "Empresa Exemplo LTDA",
"logoUrl": "https://cdn.tapsign.com.br/orgs/org_abc123/logo.png",
"role": "OWNER",
"memberCount": 12
},
{
"id": "org_def456",
"name": "Startup XYZ",
"logoUrl": null,
"role": "MEMBER",
"memberCount": 5
}
]
}

Campos da resposta

CampoTipoDescricao
idstringIdentificador unico da organizacao
namestringNome da organizacao
logoUrlstring | nullURL do logotipo da organizacao
rolestringPapel do usuario na organizacao: OWNER, ADMIN, MEMBER ou CUSTOM
memberCountintegerNumero total de membros na organizacao
Organizacao padrao

Todo usuario possui pelo menos uma organizacao (criada automaticamente no cadastro). Essa organizacao e usada como padrao quando nenhum organizationId e informado nas requisicoes.

Erros comuns

StatusCodigoDescricao
401UNAUTHORIZEDToken de autenticacao invalido ou ausente