---
title: "Consultar evidência da transação"
method: GET
path: "/v1/transactions/{transactionId}/evidence"
tags: ["Evidence"]
---

# Consultar evidência da transação

`GET /v1/transactions/{transactionId}/evidence`

## Request

- Base URL: `https://api.signdocs.com.br`
- URL: `https://api.signdocs.com.br/v1/transactions/{transactionId}/evidence`
- Auth: HTTP bearer

Retorna os metadados do pacote de evidência gerado para a transação,
incluindo hash, chave KMS e URL de download pré-assinada.

Requer scope `evidence:read`.

## Path parameters

- `transactionId` string, required

## Response `200`

Evidência retornada com sucesso.

- EvidenceResponse: Resposta com metadados da evidência.
  - `evidenceId` string, required
  - `transactionId` string, required
  - `evidenceHash` string, required: Hash SHA-256 do pacote de evidência.
  - `signatureAlg` string, required: Algoritmo de assinatura utilizado.
  - `createdAt` string, date-time, required
  - `downloadUrl` string, uri, required: URL pré-assinada para download do pacote de evidência (.p7m).

## Other responses

- `401`: Autenticação ausente ou inválida.
- `403`: Permissões insuficientes para a operação solicitada. Inclui `purpose: "ACTION_AUTHENTICATION"` sem `featureFlags.trustSessionsEnabled`. A verificação é pelo `purpose`, não pela rota: vale em `/v1/transactions`, `/v1/signing-sessions` e `/v1/envelopes/{envelopeId}/sessions`, além de `/v1/trust-sessions`. O remédio é habilitar a flag para o tenant e provisionar a cota `monthlyTrustSessions`.
- `404`: Recurso não encontrado.
- `500`: Erro interno do servidor.

---

[API](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api.md) · [All operations](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/revisions/2d3805aed161?raw)