# Documents API

Use the Documents API to download redacted outputs.

## `GET /v1/documents/{doc_id}/output`

Download the redacted PDF for a successfully processed document.

### Headers

- `X-API-Key` (required)

### Path params

- `doc_id` (required, UUID)

### cURL example

```bash
curl -sS -L "https://api.redactpdf.ai/v1/documents/DOC_ID/output" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o redacted.pdf
```

### Success

- HTTP `200`
- Content-Type: `application/pdf`
- Response body: binary PDF data

### Failure cases

- `401`: missing or invalid key
- `404`: document not found or output not ready

## Integration tip

Only attempt downloads for documents with status `redacted` from `GET /v1/jobs/{job_id}`.

## Related pages

- [Jobs API](https://redactpdf.ai/docs/api-reference/jobs.md)
- [Retention guide](https://redactpdf.ai/docs/guides/retention.md)