#fints #hbci #bank #banking #banks

bin+lib fints-institute-db

A library and CLI tool to access FinTS access information for many German banks

18 releases (10 stable)

1.2.1 Mar 27, 2021
1.2.0 Nov 14, 2020
1.0.4 Oct 7, 2020
1.0.3 Jul 23, 2020
0.2.4 Oct 24, 2018

#167 in Command line utilities

Download history 1/week @ 2020-12-24 4/week @ 2020-12-31 7/week @ 2021-01-07 6/week @ 2021-01-14 11/week @ 2021-01-21 7/week @ 2021-01-28 2/week @ 2021-02-04 82/week @ 2021-02-11 56/week @ 2021-02-18 9/week @ 2021-02-25 9/week @ 2021-03-04 4/week @ 2021-03-11 3/week @ 2021-03-18 88/week @ 2021-03-25 3/week @ 2021-04-01 27/week @ 2021-04-08

78 downloads per month
Used in 2 crates

MIT license

184 lines


CI codecov Crates.io docs license Lines of Code

This is a simple crate providing a convenient and safe interface to FinTS information of German banks. During the build it will download a CSV file with all the banks which it will then put into the library itself so that no extra files have to be taken care of.


Put this into your Cargo.toml:

fints-institute-db = "1.0"

Then to use it:

use fints_institute_db::get_bank_by_bank_code;

if let Some(bank) = get_bank_by_bank_code("12070000") {
    println!("{:?}", bank.pin_tan_address);

Other use case, find bank by BIC:

use fints_institute_db::get_bank_by_bic;

if let Some(bank) = get_bank_by_bic("GENODEM1MEN") {
    println!("{:?}", bank.pin_tan_address);

Command line utility

Additionally this crate includes a CLI tool for your convenience:

fints-institute-db 1.2.1
Sven-Hendrik Haase <svenstaro@gmail.com>
Tool to query the FinTS database.

By default it will return just the FinTS URL for the first matching bank.

    cli [FLAGS] [OPTIONS] <--iban <iban>|--bankcode <bank_code>>

    -h, --help       Prints help information
    -j, --json       Change tool behavior to output all data for the record as JSON
    -V, --version    Prints version information

    -b, --bankcode <bank_code>    Look up bank by German bank code (format: 12030000)
    -i, --iban <iban>             Look up bank by IBAN (format: DE02120300000000202051)

Example usages:

cargo run -- -b 12030000

cargo run -- -i DE02120300000000202051

This crate is inspired by https://github.com/jhermsmeier/fints-institute-db and https://github.com/dr-duplo/python-fints-url


This is mostly a note for me on how to release this thing:

  • cargo release --dry-run
  • cargo release
  • Releases will automatically be deployed by Github Actions.


~108K SLoC