DE ♦ EN

IBAN-BIC.com (Theano GmbH)  » Webservice  » Ohne SOAP  » Dokumentation: find_bank

Passwort vergessen?

Kontakt,
Impressum

Neuer Kunde? Neu anmelden

Endpunkt find_bank

URL:rest.sepatools.eu/find_bank/{searchterms}/{country}/{bankcode}/{maxitems}
Beispiel:
https://rest.sepatools.eu/find_bank/Deutsche/DE/100
findet Banken im Land "DE" (Deutschland), in deren Namen "Deutsche" vorkommt und deren Bankleitzahl irgendwo die Ziffernfolge "100" enthält.

Zweck: Volltextsuche für Banken aus allen unterstützten Ländern. Die Einschränkung auf ein bestimmtes Land ist optional - wenn Sie als zweiten Parameter einen leeren String übergeben, durchsuchen Sie alle Länder auf einmal. Auch die Einschränkung der Bankleitzahl ist optional, ebenso wie die Angabe von Suchbegriffen.

Eingabe-Parameter:

  • searchterms
    Suchbegriffe. Wenn Sie ein ganzes Wort oder mehrere ganze Wörter eingeben, geht die Suche besonders schnell und umfasst Bankname und -adresse. Geben Sie dagegen nur einen Teil eines Wortes ein, dauert die Suche ein wenig länger und umfasst nur Banknamen. Sie können diesen Parameter auch leer lassen ("" übergeben). In diesem Fall sollten Sie die Suche anderweitig eingrenzen, z. B. mit der Bankleitzahl (siehe unten). Außerdem können Sie diesen Parameter auch dazu nutzen, Banken aufgrund ihrer PAN-Nummer zu finden. Wenn eine 5-stellige Nummer und sonst nichts für diesen Parameter angegeben wird, wird die Suche auf diejenigen deutschen Banken eingeschränkt, deren PAN der angegebenen Nummer entspricht.
  • country
    Die zwei Buchstaben umfassende Länderkennung. Kann leer gelassen werden. Wird ein Land angegeben, wird die Suche auf dieses Land begrenzt; andernfalls werden alle unterstützten Länder durchsucht.
  • bankcode: xsd:string
    Optional. Wenn Sie hier eine nichtleere Zeichenfolge angeben, wird die Suche auf solche Banken begrenzt, deren Bankleitzahl die angegebene Zeichenfolge enthält.
  • maxitems
    Anzahl maximal zurückzuliefernder Suchergebnisse.

Ausgabe:

  • result: leer, falls kein Fehler aufgetreten ist. Andernfalls eine Fehlermeldung.
  • banks: Liste von Banken. Jede Bank wird in einer Datenstruktur mit folgenden Attributen geliefert:

    • name: Bankname.
    • bic: BIC.
    • bankcode: nationale Bankleitzahl.
    • address: Adresse der Bank, soweit bekannt.

  • balance: Ihr Kontostand (Anzahl verbleibender Transaktionen).