# List evidence files

Source: https://checkslip.com/en/docs/list-evidence-exports

GET `https://api.checkslip.com/api/audit/exports`

API key

Evidence files this account requested, newest first, each with its status: QUEUED, RUNNING, READY, FAILED or EXPIRED (the file was deleted). Use next_cursor for the next page. Uses no credit. Needs an API key with audit:read, or the web app sign-in.

## Parameters

| Field | In | Type | Required |
| --- | --- | --- | --- |
| `cursor` | query | `string` | no |
| `limit` | query | `integer` | no |

## Responses

### 200 `application/json`

| Field | Type | Required |
| --- | --- | --- |
| `items` | `EvidenceExport[]` | yes |
| `items[].export_id` | `string (uuid)` | yes |
| `items[].status` | `QUEUED \| RUNNING \| READY \| FAILED \| EXPIRED` | yes |
| `items[].from_day` | `string (date)` | yes |
| `items[].to_day` | `string (date)` | yes |
| `items[].streams` | `AUDIT_EVENTS[]` | yes |
| `items[].created_at` | `string (date-time)` | yes |
| `items[].created_by` | `ExportCreator` | no |
| `items[].created_by.type` | `USER \| API_KEY \| ASSISTANT \| STAFF \| SYSTEM` | yes |
| `items[].created_by.id` | `string (uuid) \| null` | no |
| `items[].ready_at` | `string (date-time) \| null` | no |
| `items[].expires_at` | `string (date-time) \| null` | no |
| `items[].manifest` | `ExportManifest \| null` | no |
| `next_cursor` | `string \| null` | yes |

### Possible errors

400 401 403 429

An error as Problem Details. All codes are listed at [Error codes](https://checkslip.com/en/docs/errors)

**cURL**

```bash
curl https://api.checkslip.com/api/audit/exports \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY"
```

**Node.js**

```javascript
const res = await fetch("https://api.checkslip.com/api/audit/exports", {
  headers: {
    Authorization: `Bearer ${process.env.CHECKSLIP_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os

import requests

res = requests.get(
    "https://api.checkslip.com/api/audit/exports",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
    },
)
data = res.json()
```

```json
{
  "items": [
    {
      "export_id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4",
      "status": "QUEUED",
      "from_day": "2026-11-05",
      "to_day": "2026-11-05",
      "streams": [
        "AUDIT_EVENTS"
      ],
      "created_at": "2026-11-05T09:30:00+07:00",
      "created_by": {
        "type": "USER",
        "id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4"
      },
      "ready_at": "2026-11-05T09:30:00+07:00",
      "expires_at": "2026-11-05T09:30:00+07:00",
      "manifest": {
        "format": "checkslip-audit-export/3",
        "record_count": 1,
        "sha256": "string",
        "size_bytes": 1
      }
    }
  ],
  "next_cursor": "string"
}
```