Download evidence
POST/v1/evidence/{evidence_id}/download
- Scopes
evidence:download- Required header
Idempotency-Key
Reveal of the original: a short-lived signed link (TTL in expires_at) for evidence:download with a required reason (EvidenceReveal); the audit event records the reason and digest. The link and bytes are never cached by clients.
Parameters
| Field | Type | Required |
|---|
evidence_idpath | string (uuid) | yes |
|---|
Request bodyEvidenceReveal
| Field | Type | Required |
|---|
reason_code | enum: case_review, appeal_review, quality_assurance, customer_support, legal_obligation | yes |
|---|
Responses
200Download400401403404409412413415422428429503
Get evidence
GET/v1/evidence/{evidence_id}
- Scopes
evidence:read
Metadata of one evidence object with its transform description; no bytes.
Parameters
| Field | Type | Required |
|---|
evidence_idpath | string (uuid) | yes |
|---|
Responses
200Evidence400401403404409412413415422428429503
Preview evidence
GET/v1/evidence/{evidence_id}/preview
- Scopes
evidence:read
Low-resolution masked projection of an admitted image for evidence:read. Video, PDF, chip data, quarantined, rejected and purged objects have no preview (409).
Parameters
| Field | Type | Required |
|---|
evidence_idpath | string (uuid) | yes |
|---|
Responses
200EvidencePreview400401403404409412413415422428429503