# One document with its revisions and where it is used

> `GET /evidence/{evidenceId}` · Scope: `read` · operationId `getEvidence`

Any member.

## Pfad-Parameter

- **evidenceId** `string (uuid)` (erforderlich)

## Antworten

### 200 (`application/json`)

The document.

- **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).
  - **access_tier** `string` (erforderlich, einer von: `public`, `legitimate_interest`, `authority`, `internal`): Access tier of a field on the passport (Art. 77(2), Annex XIII).
  - **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`)
  - **revision** `integer` (erforderlich)
  - **superseded** `boolean` (erforderlich)
  - **title** `string` (erforderlich)
- **sha256** `string` (erforderlich)
- **size_bytes** `integer (int64)` (erforderlich)
- **source** `string` (erforderlich, einer von: `manual`, `supplier`)
- **superseded** `EvidenceSupersession`
  - **at** `string (date-time)` (erforderlich)
  - **by** `UserRef`
  - **reason** `string` (erforderlich)
  - **replaced_by** `string (uuid)`
- **supersedes** `string (uuid)`: The previous revision of this document.
- **supplier_request_id** `string (uuid)`
- **title** `string` (erforderlich)
- **uploaded_by** `UserRef`
  - **display_name** `string` (erforderlich)
  - **id** `string (uuid)` (erforderlich)
- **usages** `EvidenceUsage[]`: Where the document is linked or used as a value (getEvidence only).
  - **declared_value** `any | null`: The value the document states (links only).
  - **field_key** `string` (erforderlich)
  - **target** `TargetRef` (erforderlich)
  - **target_label** `string` (erforderlich): Model name and version label, or the unit's serial number.
  - **via** `string` (erforderlich, einer von: `link`, `value`): `link`: an evidence link; `value`: the current value of a `file` field is this document.

### 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/{evidenceId}" \
  -H "Authorization: Bearer $BATTERYPASS_API_KEY"
```