# Duplikate lesen (https://developer.bimetrics.de/reference/documents/list-document-duplicates)

`GET https://app.bimetrics.de/api/document/duplicates`

operationId: `listDocumentDuplicates` · Berechtigung (Scope): `read` · Bereich: Belege

Listet die Duplikat-Einträge der Firma, neueste zuerst: Eine Datei wurde erneut hochgeladen, die die Firma schon hat, und es entstand kein zweiter Beleg. Das sind die Zeilen, die die Belegliste der App als Duplikat zeigt.

Benötigt einen Schlüssel mit der Berechtigung `read`.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `documentId` | query | nein | string | Nur die Kopien dieses Belegs. |
| `limit` | query | nein | integer | Einträge je Seite, höchstens 200, ohne Angabe 50. |
| `offset` | query | nein | integer | Zu überspringende Einträge. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/document/duplicates" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: DocumentDuplicateList |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diese Route (`APIKeyPermissionDenied`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`DocumentDuplicateList`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `items` | Array<DocumentDuplicate>, kann null sein | Einträge dieser Seite. |
| `total` | integer | Einträge insgesamt. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json