Umsätze suchen
Benötigte Berechtigung:read(Daten lesen)
Sucht Bankumsätze der Firma mit einem Filter und liefert eine Seite der Treffer. Umsätze deaktivierter Konten sind nicht enthalten.
Benötigt einen Schlüssel mit der Berechtigung read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
Filter, Sortierung und Seite. Dokumentierte Filterattribute: x-bimetrics-filter.
application/json- body
Suche mit Filter, Sortierung und Seiten. Der Filterausdruck steht auf oberster Ebene; {} liefert alle Einträge.
attribute?stringFilterattribut für eq, in, range und oneof, siehe x-bimetrics-filter der Operation. Groß-/Kleinschreibung und Punkte werden ignoriert.
children?array<>Teilfilter für and, or und not.
direction?|array<>Richtung je Eintrag in sort; Standard asc.
includeDeleted?booleantrue liefert auch gelöschte Einträge, erkennbar an deletedAt, aber nur bei Belegen, Kontakten, Bankkonten, Umsätzen und Buchungen; die übrigen Suchrouten ignorieren das Feld. Ohne das Feld oder mit false nur Einträge, die nicht gelöscht sind. Für Abgleiche von Löschungen mit range auf deletedAt, siehe Delta-Sync.
falsekind?stringArt des Filters: and/or verknüpfen children, not verneint children, eq vergleicht attribute mit value (null prüft auf leer), in sucht value als Text im Attribut (enthält, ohne Groß-/Kleinschreibung), range prüft lower ≤ Attribut ≤ upper (eine Grenze genügt), oneof prüft, ob das Attribut einem Wert der Liste value entspricht. Leer: alle Einträge.
"""and""or""eq""not""in""range""oneof"limit?integerTreffer je Seite. Standard und Höchstwert 1000; größere Werte werden auf 1000 begrenzt.
0 <= value1000lower?unknownUntergrenze für range, einschließlich.
offset?integerAnzahl übersprungener Treffer. Haben mehrere Treffer dieselben Werte in sort, ist ihre Reihenfolge nicht festgelegt, und sie können zwischen zwei Seiten doppelt kommen oder fehlen; id als letztes Attribut in sort oder ein Abgleich mit Überlappung (Delta-Sync) hilft dagegen.
0 <= value <= 10000000sort?|array<string>Attribute, nach denen sortiert wird; nur sortierbare Attribute (sortable in x-bimetrics-filter). Ein Attribut mit sortable: false ergibt 400.
upper?unknownObergrenze für range, einschließlich.
value?unknownVergleichswert: für eq ein Wert oder null, für in ein Text, für oneof eine Liste.
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 des Umsatzes. |
bankAccountId | uuid | ja | ID des Bankkontos. |
bookingDate | date | ja | Buchungstag. |
valueDate | date | ja | Wertstellung. |
transactionAmount | integer | ja | Betrag in Cent, negativ bei Ausgängen. |
otherPartyName | string | ja | Name der Gegenseite. |
remittanceInformation | string | ja | Verwendungszweck. |
status | string | ja | `booked` (gebucht) oder `pending` (vorgemerkt). |
updatedAt | date-time | ja | Zeitpunkt der letzten Änderung, auch einer Zuordnung (`match`). |
deletedAt | date-time | ja | Zeitpunkt, seit dem der Eintrag als gelöscht gilt; `null`, solange er nicht gelöscht ist. Gelöschte Einträge liefert die Suche nur mit `includeDeleted`. Für Abgleiche per Polling: `includeDeleted` und `range` mit `lower` = `deletedAt` des zuletzt gelesenen gelöschten Eintrags minus 5 Minuten Überlappung, sortiert nach `deletedAt`. |
Eine Seite der Treffer.
application/json- response
Eine Seite gefundener Umsätze.
items?array<>|Die Treffer dieser Seite.
limit?|Verwendetes limit.
offset?integerVerwendetes offset.
total?integerAnzahl aller Treffer des Filters.
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/filter" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"direction":["desc","asc"],"limit":100,"offset":0,"sort":["bookingDate","id"]}'{ "items": [ { "accountIBAN": "DE89370400440532013000", "bankAccount": { "IBAN": "DE89370400440532013000", "accountOwner": null, "accountOwnerId": "53cd10a9-c864-4dc3-a777-9860d59efe6c", "balance": 2465032, "balanceAvailable": true, "balanceCurrency": "EUR", "balanceDate": "2026-09-27T05:00:12Z", "bankName": "Commerzbank", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "connected": true, "createdAt": "2026-03-02T11:48:30Z", "currency": "EUR", "deletedAt": null, "disabled": false, "displayName": "Geschäftskonto", "id": "8faaa132-ef45-4af2-8dbb-a139b051f10f", "ownerName": "Hansen & Kowalski Werbetechnik GmbH", "productName": "Geschäftskonto", "updatedAt": "2026-09-27T05:00:12Z" }, "bankAccountId": "8faaa132-ef45-4af2-8dbb-a139b051f10f", "bookingDate": { "day": 12, "month": 9, "year": 2026 }, "bookingDateTime": null, "bookings": [ { "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", "deletedAt": null, "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" } ], "checkId": null, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T05:10:41Z", "deletedAt": null, "id": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033", "mandateId": null, "match": { "amountOpen": 0, "autoMatch": true, "bankTransactions": [ { "bankTransactionId": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:15Z", "id": "840529df-2d2a-42ea-afa3-3704d855634f", "matchId": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "updatedAt": "2026-09-12T07:30:15Z" } ], "category": "payment", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:15Z", "documents": [ { "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-12T07:30:15Z", "documentId": "3026096b-614f-40d3-8749-8acf9b529480", "id": "3432135f-5b01-4288-9764-e1ff7d061777", "matchId": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "updatedAt": "2026-09-12T07:30:15Z" } ], "id": "e21b3d18-17ea-4318-810c-919ec0a94dcb", "matchingRule": null, "matchingRuleId": null, "updatedAt": "2026-09-12T07:30:15Z" }, "otherPartyIBAN": "DE02120300000000202051", "otherPartyName": "Brauhaus Elbwiese GmbH", "otherPartyUltimate": null, "remittanceInformation": "RE-2026-0142 Brauhaus Elbwiese", "source": "bank", "status": "booked", "transactionAmount": 178500, "transactionCurrency": "EUR", "updatedAt": "2026-09-12T07:30:19Z", "valueDate": { "day": 12, "month": 9, "year": 2026 }, "valueDateTime": null }, { "accountIBAN": "DE89370400440532013000", "bankAccount": { "IBAN": "DE89370400440532013000", "accountOwner": null, "accountOwnerId": "53cd10a9-c864-4dc3-a777-9860d59efe6c", "balance": 2465032, "balanceAvailable": true, "balanceCurrency": "EUR", "balanceDate": "2026-09-27T05:00:12Z", "bankName": "Commerzbank", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "connected": true, "createdAt": "2026-03-02T11:48:30Z", "currency": "EUR", "deletedAt": null, "disabled": false, "displayName": "Geschäftskonto", "id": "8faaa132-ef45-4af2-8dbb-a139b051f10f", "ownerName": "Hansen & Kowalski Werbetechnik GmbH", "productName": "Geschäftskonto", "updatedAt": "2026-09-27T05:00:12Z" }, "bankAccountId": "8faaa132-ef45-4af2-8dbb-a139b051f10f", "bookingDate": { "day": 3, "month": 9, "year": 2026 }, "bookingDateTime": null, "bookings": [ { "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", "deletedAt": null, "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" } ], "checkId": null, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-03T05:09:58Z", "deletedAt": null, "id": "78c4ff15-f2a0-4eae-945d-73a969adab4b", "mandateId": "PW-88213-01", "match": { "amountOpen": 0, "autoMatch": false, "bankTransactions": [ { "bankTransactionId": "78c4ff15-f2a0-4eae-945d-73a969adab4b", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:37Z", "id": "b06c1337-d724-4854-bba8-d52bc6355c8b", "matchId": "d00419ed-ecab-4800-ad69-d482b73a6961", "updatedAt": "2026-09-04T08:02:37Z" } ], "category": "payment", "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:37Z", "documents": [ { "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:37Z", "documentId": "a129ef0a-da5d-4204-804c-764d751bca95", "id": "e1331e65-c539-4c84-9271-66cc20f52910", "matchId": "d00419ed-ecab-4800-ad69-d482b73a6961", "updatedAt": "2026-09-04T08:02:37Z" } ], "id": "d00419ed-ecab-4800-ad69-d482b73a6961", "matchingRule": { "active": true, "companyId": "9c388e1f-04a6-4770-80bd-66cd98dd00d5", "createdAt": "2026-09-04T08:02:41Z", "id": "5e0f6a4b-8d2c-4f7e-9b1a-3c6d2e8f4a71", "updatedAt": "2026-09-04T08:02:41Z" }, "matchingRuleId": "5e0f6a4b-8d2c-4f7e-9b1a-3c6d2e8f4a71", "updatedAt": "2026-09-04T08:02:37Z" }, "otherPartyIBAN": "DE02500105170137075030", "otherPartyName": "Papierhaus Wendt KG", "otherPartyUltimate": null, "remittanceInformation": "Rechnung 2026-5531 Kd-Nr. 88213", "source": "bank", "status": "booked", "transactionAmount": -4389, "transactionCurrency": "EUR", "updatedAt": "2026-09-04T08:02:40Z", "valueDate": { "day": 3, "month": 9, "year": 2026 }, "valueDateTime": null } ], "limit": 100, "offset": 0, "total": 2}