Zahlungsverkehr

BIC zu einer deutschen Bankleitzahl ermitteln

Liefert den BIC zu einer deutschen Bankleitzahl aus dem Bundesbank-Verzeichnis. Andere Länder liefern immer found=false mit reason='unsupported_country', dafür ist der BIC aus der Quelldatei (DTAZV) oder aus manueller Eingabe zu nehmen. Erfordert das Feature 'payments' ODER 'paymentsAbroad' (Zahlungsverkehr-Abo bzw. Auslandsmodul-Add-on schließt es ein). Auth per Login-Session oder Bearer-Credential (API-Key oder OAuth-Token), unabhängig vom Scope: diese Route prüft keinen OAuth-Scope, nur das Konto-Feature.

get/payments/bank-lookup

Request

  • Base URL: https://finisma.de/api/v1
  • URL: https://finisma.de/api/v1/payments/bank-lookup
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://finisma.de/api/oauth/authorize, token URL https://finisma.de/api/oauth/token, scopes: invoice:verify, invoice:create)

Query parameters

countrystring

ISO-3166-1-alpha-2-Ländercode. Nur 'DE' kann einen Treffer liefern; jeder andere Wert (auch ein leerer) liefert found=false mit reason='unsupported_country'.

bankCodestring

Die deutsche Bankleitzahl (BLZ), achtstellig.

Response

Ergebnis der Suche: auch 'nicht gefunden' bzw. 'Land nicht unterstützt' ist ein 200.

foundboolean required
bicstring

Nur bei found=true.

bankNamestring

Nur bei found=true.

dataDatestring

Stichtag der zugrunde liegenden Bundesbank-Datei (YYYY-MM-DD). Nur bei found=true.

reason'unsupported_country'

Nur gesetzt, wenn country ungleich 'DE' war.

Changes

No recorded changes to this operation across all 1 revision of this API.