> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyformat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Deletion Certificates

> List a workflow's deletion certificates, one per deleted document packet

*Rate limit tier: **general**, 600 requests/min. See [Rate limits](https://docs.anyformat.ai/api-reference-v3/introduction.md#rate-limits).*

> [!NOTE]
>
> Available to organizations with **zero data retention** only. Any other organization gets `403` with `error_code: ZERO_DATA_RETENTION_REQUIRED`.

Returns a workflow's [deletion certificates](https://docs.anyformat.ai/api-reference-v3/deletion-certificates/overview.md), one per deleted document packet, newest issued first. It answers after the workflow is deleted, and a workflow with no purged packet returns an empty page. Items carry no signed document; fetch one with [Get Deletion Certificate](https://docs.anyformat.ai/api-reference-v3/deletion-certificates/get.md). Follow `next_cursor` until it is `null`. See [Pagination](https://docs.anyformat.ai/api-reference-v3/introduction.md#pagination).

```bash curl theme={null}
curl -X GET 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/deletion-certificates/?limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```python Python (SDK) theme={null}
from anyformat.sdk import Client

client = Client(api_key="YOUR_API_KEY")

for certificate in client.iter_deletion_certificates("0686bb97-8c30-70f0-8000-97669e000eb8"):
    print(certificate.id, certificate.document_packet_id, certificate.status, certificate.assurance)
```

```typescript TypeScript (SDK) theme={null}
import { Anyformat } from "@anyformat/sdk";

const af = new Anyformat({ apiKey: "YOUR_API_KEY" });

for await (const certificate of af.iterDeletionCertificates("0686bb97-8c30-70f0-8000-97669e000eb8")) {
  console.log(certificate.id, certificate.document_packet_id, certificate.status, certificate.assurance);
}
```

```json Response (200 OK) theme={null}
{
  "items": [
    {
      "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4f0",
      "workflow_id": "0686bb97-8c30-70f0-8000-97669e000eb8",
      "document_packet_id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e1",
      "deletion_kind": "packet",
      "status": "final",
      "assurance": "destroyed",
      "files": [
        { "id": "069dcc2c-e14c-7606-8000-2ee4fb17b4e2", "filename": "invoice-0042.pdf", "created_at": "2026-10-01T09:00:00Z" }
      ],
      "requested_at": "2026-10-02T09:00:00Z",
      "forgotten_at": "2026-10-03T09:00:00Z",
      "issued_at": "2026-10-03T09:00:00Z",
      "finalized_at": "2026-10-03T09:05:00Z",
      "signed_at": "2026-10-03T09:10:00Z"
    }
  ],
  "next_cursor": null
}
```

```json Response (403 Forbidden) theme={null}
{
  "error": "Only an organization with zero data retention can use this.",
  "detail": "Deletion certificates are served to organizations with zero data retention only.",
  "error_code": "ZERO_DATA_RETENTION_REQUIRED",
  "retryable": false,
  "request_id": "a1b2c3d4e5f67890abcdef1234567890"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.