# The evidence library, newest first

> `GET /evidence` · Scope: `read` · operationId `listEvidence`

Any member. Superseded revisions are left out unless `include_superseded=true`.

## Query-Parameter

- **limit** `integer` (Standard: 50): Maximum number of items to return.
- **cursor** `string`: Opaque cursor from a previous page's `next_cursor`.
- **kind** `string` (einer von: `declaration_of_conformity`, `test_report`, `dismantling_manual`, `safety_instructions`, `datasheet`, `diagnostic_report`, `study`, `image`, `other`)
- **include_superseded** `boolean` (Standard: false)

## Antworten

### 200 (`application/json`)

A page of documents.

- **items** `Evidence[]` (erforderlich)
  - **access_tier** `string` (erforderlich, einer von: `public`, `legitimate_interest`, `authority`, `internal`): Access tier of a field on the passport (Art. 77(2), Annex XIII).
  - **created_at** `string (date-time)` (erforderlich)
  - **filename** `string` (erforderlich)
  - **id** `string (uuid)` (erforderlich)
  - **kind** `string` (erforderlich, einer von: `declaration_of_conformity`, `test_report`, `dismantling_manual`, `safety_instructions`, `datasheet`, `diagnostic_report`, `study`, `image`, `other`)
  - **mime** `string` (erforderlich)
  - **revision** `integer` (erforderlich)
  - **revisions** `EvidenceRef[]`: All revisions of the document, newest first (getEvidence only).
  - **sha256** `string` (erforderlich)
  - **size_bytes** `integer (int64)` (erforderlich)
  - **source** `string` (erforderlich, einer von: `manual`, `supplier`)
  - **superseded** `EvidenceSupersession`
  - **supersedes** `string (uuid)`: The previous revision of this document.
  - **supplier_request_id** `string (uuid)`
  - **title** `string` (erforderlich)
  - **uploaded_by** `UserRef`
  - **usages** `EvidenceUsage[]`: Where the document is linked or used as a value (getEvidence only).
- **next_cursor** `string | null` (erforderlich): Cursor for the next page, or null when this is the last page.

### 400 (`application/problem+json`)

The request is malformed or failed validation (`validation_error`), or a token is invalid or expired (`invalid_token`).

### 401 (`application/problem+json`)

The API key is missing, unknown or revoked (`unauthenticated`).

### 403 (`application/problem+json`)

The API key may not perform this action (`forbidden`): it lacks the operation's scope, or the action needs more than a viewer's rights.

### 404 (`application/problem+json`)

The resource does not exist in the organisation of the API key, or the public passport is unknown (`not_found`).

### default (`application/problem+json`)

Any other problem, e.g. `internal_error`.

## Beispiel

```bash title="cURL"
curl -X GET "https://passport.kabin.sh/api/v1/evidence" \
  -H "Authorization: Bearer $BATTERYPASS_API_KEY"
```