bimetricsEntwickler
Bankkonten

Bankkonten suchen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/bankaccount/filter

Sucht die verbundenen Bankkonten der Firma mit einem Filter und liefert eine Seite der Treffer. accountOwner nennt nur die Mitgliedschaft des Kontoinhabers, keine Personendaten.

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

Authentifizierung

AuthentifizierungBearer <token>

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.

AttributTypSortierbarBeschreibung
ibanstringjaIBAN des Kontos.
bankNamestringjaName der Bank.
ownerNamestringjaName des Kontoinhabers laut Bank.
currencystringjaKontowährung (ISO 4217).
disabledbooleanjaKonto ist deaktiviert.
updatedAtdate-timejaZeitpunkt der letzten Änderung.

Antworten

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://app.bimetrics.de/api/bankaccount/filter" \  -H "Content-Type: application/json" \  -d '{}'
{  "items": [    {      "IBAN": "string",      "accountOwner": {        "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",        "createdAt": "2019-08-24T14:15:22Z",        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "role": "owner",        "status": "active",        "updatedAt": "2019-08-24T14:15:22Z",        "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b"      },      "accountOwnerId": "41bfc29a-63f5-4057-9938-10cfd5e1771b",      "balance": 0,      "balanceAvailable": true,      "balanceCurrency": "string",      "balanceDate": "2019-08-24T14:15:22Z",      "bankName": "string",      "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",      "createdAt": "2019-08-24T14:15:22Z",      "currency": "string",      "disabled": true,      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "ownerName": "string",      "productName": "string",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "limit": 0,  "offset": 0,  "total": 0}