Buchungen suchen
Benötigte Berechtigung:read(Daten lesen)
Sucht Buchungen der Firma mit einem Filter und liefert eine Seite der Treffer.
Benötigt einen Schlüssel mit der Berechtigung read.
Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
In: header
Request-Body
application/json
Filter, Sortierung und Seite. Dokumentierte Filterattribute: x-bimetrics-filter.
TypeScript-Typen
Typ request body für TypeScript.
Suche mit Filter, Sortierung und Seiten. Der Filterausdruck steht auf oberster Ebene; {} liefert alle Einträge.
Filterattribute
Dokumentiert sind diese Attribute für attribute; für sort nur die als sortierbar markierten. Aufbau des Filters: Filtern und Paginieren.
| Attribut | Typ | Sortierbar | Beschreibung |
|---|---|---|---|
id | uuid | ja | ID der Buchung. |
bookingDate | date | ja | Buchungsdatum. |
account | integer | ja | Konto. |
accountContra | integer | ja | Gegenkonto. |
amount | decimal | ja | Betrag. |
refDocumentId | uuid | ja | ID des gebuchten Belegs. |
refBankTransactionId | uuid | ja | ID des gebuchten Umsatzes. |
finalized | date-time | ja | Zeitpunkt der Festschreibung; `null` bei nicht festgeschriebenen Buchungen. |
updatedAt | date-time | ja | Zeitpunkt der letzten Änderung. |
Antworten
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl --fail-with-body "https://app.bimetrics.de/api/accounting/booking/filter" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"direction":["desc","asc"],"limit":100,"offset":0,"sort":["bookingDate","id"]}'{ "items": [ { "account": 1201, "accountContra": 11004, "accountingModel": "SKR03", "amount": "1785", "bookingDate": { "day": 12, "month": 9, "year": 2026 }, "bookingFlags": "", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:19Z", "finalized": null, "id": "a91d68ff-83b1-43a7-b373-91eb6adcebc6", "label": "Zahlung, Brauhaus Elbwiese GmbH, RE-2026-0142", "performanceFrom": null, "performanceTo": null, "refBankTransactionId": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033", "refDocumentId": null, "refMatch": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "revertsAccountBookingId": null, "updatedAt": "2026-09-12T07:30:19Z" }, { "account": 1201, "accountContra": 71007, "accountingModel": "SKR03", "amount": "-43.89", "bookingDate": { "day": 3, "month": 9, "year": 2026 }, "bookingFlags": "", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:40Z", "finalized": null, "id": "2f279ef2-0219-4b84-b04f-4d73e4ce6812", "label": "Zahlung, Papierhaus Wendt KG, 2026-5531", "performanceFrom": null, "performanceTo": null, "refBankTransactionId": "78c4ff15-f2a0-4eae-945d-73a969adab4b", "refDocumentId": null, "refMatch": "d00419ed-ecab-4800-ad69-d482b73a6961", "revertsAccountBookingId": null, "updatedAt": "2026-09-04T08:02:40Z" }, { "account": 8400, "accountContra": 11004, "accountingModel": "SKR03", "amount": "-1785", "bookingDate": { "day": 1, "month": 9, "year": 2026 }, "bookingFlags": "ust19%", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:19Z", "finalized": null, "id": "743f74e5-29fb-46ba-b919-21e48af483be", "label": "Brauhaus Elbwiese GmbH, Fassadenbeschriftung Entwurf und Montage", "performanceFrom": { "day": 1, "month": 9, "year": 2026 }, "performanceTo": { "day": 1, "month": 9, "year": 2026 }, "refBankTransactionId": null, "refDocumentId": "3026096b-614f-40d3-8749-8acf9b529480", "refMatch": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "revertsAccountBookingId": null, "updatedAt": "2026-09-12T07:30:19Z" }, { "account": 4930, "accountContra": 71007, "accountingModel": "SKR03", "amount": "43.89", "bookingDate": { "day": 27, "month": 8, "year": 2026 }, "bookingFlags": "v19%", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:40Z", "finalized": "2026-09-05T10:41:09Z", "id": "f00b48c7-6eb3-4082-aba2-917944ac5f93", "label": "Papierhaus Wendt KG, Kopierpapier A4 10 Pakete", "performanceFrom": { "day": 27, "month": 8, "year": 2026 }, "performanceTo": { "day": 27, "month": 8, "year": 2026 }, "refBankTransactionId": null, "refDocumentId": "a129ef0a-da5d-4204-804c-764d751bca95", "refMatch": "d00419ed-ecab-4800-ad69-d482b73a6961", "revertsAccountBookingId": null, "updatedAt": "2026-09-05T10:41:09Z" } ], "limit": 100, "offset": 0, "total": 4}Kontenbezeichnungen auflisten GET
Liefert die Kontenbezeichnungen des Kontenrahmens der Firma: Bankkonten, Debitoren und Kreditoren der Kontakte sowie die Standardkonten. Ein Eintrag gilt für die Kontonummern von `from` bis `to`. Benötigt einen Schlüssel mit der Berechtigung `read`.
Buchung lesen GET
Liefert eine Buchung. Benötigt einen Schlüssel mit der Berechtigung `read`.