Detalhar Signatario

Retorna as informacoes completas de um signatario e do documento associado. Este e um endpoint publico -- nao requer autenticacao, pois e acessado diretamente pelo signatario atraves do link de assinatura.

Endpoint

GET /v1/signing/{token}

Endpoint publico

Este endpoint nao exige o header Authorization. O token na URL ja identifica o signatario de forma segura.

Parametros de URL

Parametro	Tipo	Obrigatorio	Descricao
token	string	Sim	Token unico do signatario (recebido por email ou WhatsApp)

Exemplo de Requisicao

curl -X GET https://api.tapsign.com.br/v1/signing/abc123def456

Resposta de Sucesso

Status: 200 OK

{
  "signer": {
    "id": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
    "name": "Joao da Silva",
    "email": "joao@empresa.com.br",
    "role": "SIGNER",
    "status": "PENDING",
    "viewedAt": null,
    "signedAt": null,
    "declinedAt": null
  },
  "envelope": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Contrato de Prestacao de Servicos",
    "status": "SENT",
    "createdAt": "2026-03-29T14:30:00Z",
    "expiresAt": "2026-04-28T23:59:59Z"
  },
  "documents": [
    {
      "id": "d1e2f3a4-b5c6-7890-1234-567890abcdef",
      "name": "contrato-servicos.pdf",
      "pages": 5,
      "downloadUrl": "https://api.tapsign.com.br/v1/signing/abc123def456/documents/d1e2f3a4-b5c6-7890-1234-567890abcdef"
    }
  ],
  "otherSigners": [
    {
      "name": "Maria Souza",
      "role": "WITNESS",
      "status": "SIGNED",
      "signedAt": "2026-03-29T16:00:00Z"
    }
  ]
}

Campos da Resposta

Objeto signer

Campo	Tipo	Descricao
id	string (UUID)	ID unico do signatario
name	string	Nome do signatario
email	string	Email do signatario
role	string	Papel: SIGNER, WITNESS, APPROVER, CARBON_COPY
status	string	Status atual: PENDING, VIEWED, SIGNED, DECLINED
viewedAt	string ou null	Data em que o signatario visualizou o documento
signedAt	string ou null	Data em que o signatario assinou
declinedAt	string ou null	Data em que o signatario recusou

Objeto envelope

Campo	Tipo	Descricao
id	string (UUID)	ID do envelope
name	string	Nome do envelope
status	string	Status do envelope
createdAt	string (ISO 8601)	Data de criacao
expiresAt	string ou null	Data de expiracao

Array documents

Campo	Tipo	Descricao
id	string (UUID)	ID do documento
name	string	Nome do arquivo
pages	number	Numero de paginas
downloadUrl	string	URL para download do documento

Array otherSigners

Campo	Tipo	Descricao
name	string	Nome do outro signatario
role	string	Papel atribuido
status	string	Status da assinatura
signedAt	string ou null	Data da assinatura

Status do signatario

O campo status progride da seguinte forma:

1. PENDING -- Convite enviado, aguardando acao
2. VIEWED -- O signatario abriu o documento
3. SIGNED -- O signatario assinou com sucesso
4. DECLINED -- O signatario recusou assinar

Erros

Codigo	Descricao
404	Token invalido ou signatario nao encontrado
410	Envelope expirado ou cancelado