{"id":28158215,"url":"https://github.com/baumerdev/bankdata-germany","last_synced_at":"2025-05-15T09:19:06.184Z","repository":{"id":62001252,"uuid":"556294395","full_name":"baumerdev/bankdata-germany","owner":"baumerdev","description":"Data and BIC Validator for German Banks","archived":false,"fork":false,"pushed_at":"2025-02-09T17:31:21.000Z","size":685,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-11T17:39:29.916Z","etag":null,"topics":["bic","german","germany","sepa","swift-codes","validator"],"latest_commit_sha":null,"homepage":"https://baumerdev.github.io/bankdata-germany/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/baumerdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-23T14:24:43.000Z","updated_at":"2025-05-09T14:58:15.000Z","dependencies_parsed_at":"2023-01-23T18:15:48.967Z","dependency_job_id":"ec0196c6-a343-4485-a806-91672a70448d","html_url":"https://github.com/baumerdev/bankdata-germany","commit_stats":{"total_commits":27,"total_committers":2,"mean_commits":13.5,"dds":0.07407407407407407,"last_synced_commit":"38ed9a1fe5e6dcda3dad653d2d47d97a4ea0ecd4"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baumerdev%2Fbankdata-germany","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baumerdev%2Fbankdata-germany/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baumerdev%2Fbankdata-germany/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baumerdev%2Fbankdata-germany/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/baumerdev","download_url":"https://codeload.github.com/baumerdev/bankdata-germany/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254310489,"owners_count":22049470,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bic","german","germany","sepa","swift-codes","validator"],"created_at":"2025-05-15T09:16:31.326Z","updated_at":"2025-05-15T09:19:06.096Z","avatar_url":"https://github.com/baumerdev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BankData-Germany: Data and BIC Validator for German Banks.\n\n![CI: Lint, test and build](https://github.com/baumerdev/bankdata-germany/workflows/Lint,%20test%20and%20build/badge.svg?branch=main)\n[![Coverage Status](https://coveralls.io/repos/github/baumerdev/bankdata-germany/badge.svg?branch=main)](https://coveralls.io/github/baumerdev/bankdata-germany?branch=main)\n\nThis TypeScript/JavaScript library contains bank data for German banks, such\nas names and BIC/SWIFT codes. You can use it (for example) to enhance user\ninterfaces/forms, where a user enters an IBAN and you automatically fill out\nthe bank name and BIC fields.\n\nThis library is not an IBAN validator itself. If you require validation,\nplease refer to the main project. [IBANTools-Germany](https://baumerdev.github.io/ibantools-germany/).\n\n\u003e _Version 1.2500.* includes data from 2024-12-09 to 2025-03-02, as well as from 2025-03-03 to 2025-06-08. Validation will be based on the data that is valid according to your system time (data changes at midnight CET on 2025-03-03)._\n\n* [Installation](#installation)\n* [Usage](#usage)\n* [Data Source](#data-source)\n* [Package Version](#package-version)\n\n## Installation\n\n### Package Manager\n\nAdd it to your project using a package manager like npm or yarn. You should\nexplicitly install the latest version, as the bank data may change multiple\ntimes a year.\n\n```sh\n$ npm install --save bankdata-germany@latest\n# or\n$ yarn add bankdata-germany@latest\n```\n\n### Browser / CDN\n\nIf you only want the functions in your browser, you can include the following\npre-built file.\n\n```html\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/bankdata-germany/dist/build/browser.js\"\u003e\u003c/script\u003e\n```\n\n## Usage\n\nThe npm package contains the code for both ESM and CJS. Therefore, in addition\nto using `import` as shown in the usage examples below, you can also utilize\n`require`.\n\n### IBAN / Bank Details\n\nYou can retrieve detailed information for a bank using BLZ, BBAN, or IBAN.\n\nNote: When using the BBAN/IBAN function, no verification will be performed. It\nsolely extracts the BLZ and verifies its existence.\n\n```javascript\nimport { bankDataByBLZ, bankDataByBIC, bankDataByBBAN, bankDataByIBAN } from \"bankdata-germany\"\n\nbankDataByBLZ(\"10010010\");\nbankDataByBIC(\"PBNKDEFFXXX\");\nbankDataByBBAN(\"100100100000138301\");\nbankDataByIBAN(\"DE48100100100000138301\");\n// {\n//   bankName: \"Postbank Ndl der Deutsche Bank\",\n//   bic: \"PBNKDEFFXXX\",\n//   blz: \"10010010\"\n// }\n```\n\n### Validation\n\nYou can validate BIC/SWIFT codes. However, despite these formats being\ninternational standards, this library exclusively validates data for Germany\nand will return \"false\" for all other countries.\n\n```javascript\nimport { isValidBIC } from \"bankdata-germany\"\n\nisValidBIC(\"MARKDEFF\"); // true\nisValidBIC(\"MARKDEFFXXX\"); // true\nisValidBIC(\"foobar\"); // false (invalid format)\nisValidBIC(\"BNPAFRPH\"); // false (corrent but not a German BIC)\n```\n\n### Browser / CDN\n\nWhen using the pre-built version, the `bankdataGermany` object is globally\ndefined on the `window`, containing the functions.\n\n```javascript\nbankdataGermany.bankDataByBLZ(\"10010010\");\nbankdataGermany.bankDataByBIC(\"PBNKDEFFXXX\");\nbankdataGermany.bankDataByBBAN(\"100100100000138301\");\nbankdataGermany.bankDataByIBAN(\"DE48100100100000138301\");\nbankdataGermany.isValidBIC(\"MARKDEFF\");\n```\n\n## Data Source\n\nBank data is sourced from the official website of\n[Deutsche Bundesbank](https://www.bundesbank.de/en/tasks/payment-systems/services/bank-sort-codes/download-bank-sort-codes-626218)\nwhich publishes updated data every quarter.\n\nThese updates can encompass both technical changes, such as modifications in\ncheck digit methods, as well as content changes like alterations to BLZ, bank\nnames, and more. Some updates might not contain any relevant changes for this\nlibrary at all.\n\n## Package Version\n\nThe version numbers are based on [Semantic Versioning](https://semver.org/)\nwith some modifications.\n\n\u003e 1.2205.3\n\nThe first number represents the Major version. If this number increases, there\nmay be updates that are not backward compatible, requiring adjustments to your\ncode. In the above version string, the major version is **1**.\n\nThe first two digits of the second number indicate the year of the included data\nand check digit methods. The third and fourth digits increase either with minor\nversion changes that maintain backward compatibility or when new data is\nincluded. In the provided version string, the year is 20**22**, with a few minor\nupdates, possibly including data updates for spring and summer.\n\nThe last number is reserved for patches and bug fixes.\n\nConsidering that the data could change up to four times a year, it's advisable\nto use an appropriate version string in your package.json. As breaking changes\noccur only when the first number changes, specifying something like `\"1.x\"`\nshould suffice.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaumerdev%2Fbankdata-germany","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbaumerdev%2Fbankdata-germany","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaumerdev%2Fbankdata-germany/lists"}