# Endpunkte (https://developer.bimetrics.de/referenz)

Alle Endpunkte der bimetrics API mit Parametern, Antworten und Playground.

Die Referenz entsteht aus der [OpenAPI-Beschreibung](https://app.bimetrics.de/api/openapi.json) des Backends. Alle Pfade beginnen mit `https://app.bimetrics.de/api/`, authentifiziert wird mit `Authorization: Bearer bm_…` (siehe [Authentifizierung](/authentifizierung)).

### Belege

| Endpunkt | Beschreibung | Berechtigung |
| --- | --- | --- |
| [`POST /api/document/`](https://developer.bimetrics.de/referenz/belege/upload-document.md) | Beleg hochladen | upload |
| [`POST /api/document/filter`](https://developer.bimetrics.de/referenz/belege/filter-documents.md) | Belege suchen | read |
| [`GET /api/document/{id}`](https://developer.bimetrics.de/referenz/belege/get-document.md) | Beleg lesen | read |
| [`GET /api/document/{id}/content`](https://developer.bimetrics.de/referenz/belege/get-document-content.md) | Originaldatei eines Belegs laden | read |

### Kontakte

| Endpunkt | Beschreibung | Berechtigung |
| --- | --- | --- |
| [`POST /api/contact/filter`](https://developer.bimetrics.de/referenz/kontakte/filter-contacts.md) | Kontakte suchen | read |
| [`GET /api/contact/{id}`](https://developer.bimetrics.de/referenz/kontakte/get-contact.md) | Kontakt lesen | read |

### Bankkonten

| Endpunkt | Beschreibung | Berechtigung |
| --- | --- | --- |
| [`POST /api/bankaccount/filter`](https://developer.bimetrics.de/referenz/bankkonten/filter-bank-accounts.md) | Bankkonten suchen | read |
| [`GET /api/bankaccount/{id}`](https://developer.bimetrics.de/referenz/bankkonten/get-bank-account.md) | Bankkonto lesen | read |

### Umsätze

| Endpunkt | Beschreibung | Berechtigung |
| --- | --- | --- |
| [`POST /api/banktransaction/filter`](https://developer.bimetrics.de/referenz/umsaetze/filter-bank-transactions.md) | Umsätze suchen | read |
| [`GET /api/banktransaction/{id}`](https://developer.bimetrics.de/referenz/umsaetze/get-bank-transaction.md) | Umsatz lesen | read |

### Buchhaltung

| Endpunkt | Beschreibung | Berechtigung |
| --- | --- | --- |
| [`GET /api/accounting/accounts/`](https://developer.bimetrics.de/referenz/buchhaltung/list-used-accounts.md) | Bebuchte Konten auflisten | read |
| [`GET /api/accounting/accounts/labels/`](https://developer.bimetrics.de/referenz/buchhaltung/list-account-labels.md) | Kontenbezeichnungen auflisten | read |
| [`POST /api/accounting/booking/filter`](https://developer.bimetrics.de/referenz/buchhaltung/filter-bookings.md) | Buchungen suchen | read |
| [`GET /api/accounting/booking/{id}`](https://developer.bimetrics.de/referenz/buchhaltung/get-booking.md) | Buchung lesen | read |

### Tarif

| Endpunkt | Beschreibung | Berechtigung |
| --- | --- | --- |
| [`GET /api/entitlement/`](https://developer.bimetrics.de/referenz/tarif/get-entitlement.md) | Tarif und Kontingent lesen | read |

## Playground

Auf den Seiten der lesenden Endpunkte kannst du Anfragen direkt ausprobieren. Der Playground sendet sie aus deinem Browser unmittelbar an `app.bimetrics.de`; der Schlüssel läuft nicht über developer.bimetrics.de.

* Aus dem Browser funktioniert nur `Authorization: Bearer`. Den Header `X-API-KEY` lässt der Browser nicht zu, weil `app.bimetrics.de` ihn bei Anfragen von anderen Websites (CORS) nicht erlaubt.
* Der Schlüssel bleibt nur während deines Besuchs im Browser gespeichert. Er wird gelöscht, wenn du die Seite verlässt oder neu lädst. Überspringt der Browser das, wird er beim nächsten Besuch gelöscht.

Die Antworten enthalten echte Daten deiner Firma. Nutze den Playground nur auf einem Gerät, dem du vertraust. Für den Upload gibt es keinen Testversand, weil jeder Aufruf einen echten Beleg anlegt.