---
title: "Download the annotated evidence crop for a defect_evidence row"
method: GET
path: "/defect-evidence/{evidenceId}/download"
tags: ["Media"]
---

# Download the annotated evidence crop for a defect_evidence row

`GET /defect-evidence/{evidenceId}/download`

## Request

- Base URL: `https://api.voltairlabs.com`
- URL: `https://api.voltairlabs.com/defect-evidence/{evidenceId}/download`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/voltairlabs/apis/voltair-api/docs/defect-evidence/:evidenceId/download/get.ts> (a function with typed inputs; its response is checked against the schema)

Renders the downloadable artifact for one defect_evidence row on
demand. When the row carries a bbox, the response is the ORIGINAL
photo cropped to a square window with 30% margin around the bbox and
the bbox stroked in the defect's priority color — exactly what the
platform's evidence viewer shows on screen. When the row has no bbox
(non-CVAT-sourced evidence), the original object is streamed
unmodified. Replaces the retired stored crop derivatives.

## Response `200`

Annotated crop JPEG (or the original object when no bbox)

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions
- `404`: Resource not found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `502`: Upstream S3 read failed

---

[API](https://skmtc.dev/voltairlabs/apis/voltair-api.md) - [All operations](https://skmtc.dev/voltairlabs/apis/voltair-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voltairlabs/apis/voltair-api/revisions/ad57aa0e0c40?raw)