Registry / database / fints-institute-db

fints-institute-db

library0.16.0jsnpmunverified

fints-institute-db is a JavaScript package providing a structured database of German banking institutes, primarily for use with FinTS/HBCI client applications. It contains crucial connection details such as Bankleitzahl (BLZ), Business Identifier Code (BIC), bank name, location, FinTS endpoint URLs (e.g., `pinTanURL`), and supported FinTS protocol versions. The current stable version is 0.16.0. The package typically receives updates as the German banking landscape changes (e.g., mergers, updated FinTS endpoints) or new data becomes available, making its release cadence data-driven. It serves as a static registry, differentiating itself by offering a readily consumable, open-source dataset specifically tailored for integrating with the German FinTS standard.

database

github ↗package ↗

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

The package exports the entire bank list as its default export, which is an array. There are no named exports.

import banks from 'fints-institute-db';

CommonJS default import for Node.js environments. The exported value is an array.

const banks = require('fints-institute-db');

If using TypeScript, explicit type imports for the structure of a single bank entry are available from a subpath. The package might not always ship with comprehensive type definitions, so community-provided types (`@types/fints-institute-db`) might be needed for older versions or more specific fields.

import type { BankInstitute } from 'fints-institute-db/types';

Demonstrates how to import the bank database, find a specific bank by BLZ, filter banks by organization, and access their properties.

import banks from 'fints-institute-db'; // Find a bank by its Bankleitzahl (BLZ) const blzToFind = '10030600'; // Example BLZ for 'Bankhaus Kruber' const bankByBlz = banks.find(bank => bank.blz === blzToFind); if (bankByBlz) { console.log(`Found bank '${bankByBlz.name}' in '${bankByBlz.location}' with HBCI URL: ${bankByBlz.pinTanURL}`); } else { console.log(`Bank with BLZ ${blzToFind} not found.`); } // Filter banks by organization (e.g., 'DSGV' for Sparkassen) const dsgvBanks = banks.filter(bank => bank.organisation === 'DSGV'); console.log(` Found ${dsgvBanks.length} banks belonging to DSGV (Sparkassen-Finanzgruppe). Example:`); if (dsgvBanks.length > 0) { console.log(` - ${dsgvBanks[0].name}, BIC: ${dsgvBanks[0].bic}`); } // Get a count of all registered banks console.log(`\nTotal number of banks in the database: ${banks.length}`);

Debug

Known footguns

breakingMajor version updates (e.g., v0.x.x to v1.x.x) may introduce changes to the data schema (e.g., renaming fields like `blz`, `bic`, `pinTanURL`, or adding/removing flags like `rdh7`). This could break applications relying on specific field names or data types.

gotchaThe `pinTanURL` and `hbciDomain` fields, which are critical for FinTS connections, can change without immediate package updates. Relying solely on this static database for real-time endpoint validity in production environments might lead to connection failures.

gotchaThe `updated` field for individual bank entries is often `null` in the provided data format. This makes it difficult to ascertain the freshness of specific bank data points directly from the entry itself.

gotchaWhile the package aims for comprehensive coverage, it might not always include every niche banking institute or reflect the very latest changes from all German financial institutions immediately. Data is community-driven and updated periodically.

Upgrade

Version history

Breaking-change detection hasn't run for this library yet.

Audit

Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity

14 hits · last 30 days

gptbot

ahrefsbot

amazonbot

script

bingbot

Resources

githubhttps://github.com/jhermsmeier/fints-institute-db ↗

packagehttps://www.npmjs.com/package/fints-institute-db ↗