{"id":18487323,"url":"https://github.com/Simplify/ibantools","last_synced_at":"2025-04-08T20:30:55.297Z","repository":{"id":37405629,"uuid":"47496099","full_name":"Simplify/ibantools","owner":"Simplify","description":"IBANTools is TypeScript/JavaScript library for validation, creation and extraction of IBAN, BBAN and BIC/SWIFT numbers.","archived":false,"fork":false,"pushed_at":"2024-10-29T13:06:13.000Z","size":2480,"stargazers_count":204,"open_issues_count":8,"forks_count":41,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-10-29T21:03:49.690Z","etag":null,"topics":["bban","bic","iban","iso-3136-1-alpha-2","iso3166","javascript","javascript-library","sepa","swift","typescript"],"latest_commit_sha":null,"homepage":"http://simplify.github.io/ibantools","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Simplify.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-12-06T12:37:16.000Z","updated_at":"2024-10-26T01:47:19.000Z","dependencies_parsed_at":"2023-10-15T18:02:00.448Z","dependency_job_id":"8f06576d-36bd-469c-86d7-69901fdd8f0f","html_url":"https://github.com/Simplify/ibantools","commit_stats":{"total_commits":488,"total_committers":16,"mean_commits":30.5,"dds":"0.47745901639344257","last_synced_commit":"eba2187ab50eac7b4eb5f0cd70889177c31591a9"},"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simplify%2Fibantools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simplify%2Fibantools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simplify%2Fibantools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Simplify%2Fibantools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Simplify","download_url":"https://codeload.github.com/Simplify/ibantools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247509219,"owners_count":20950232,"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":["bban","bic","iban","iso-3136-1-alpha-2","iso3166","javascript","javascript-library","sepa","swift","typescript"],"created_at":"2024-11-06T12:50:24.157Z","updated_at":"2025-04-08T20:30:55.251Z","avatar_url":"https://github.com/Simplify.png","language":"JavaScript","readme":"# IBANTools\n\n![License](https://img.shields.io/badge/License-MIT-blue)\n![License](https://img.shields.io/badge/License-MPL_2.0-blue)\n\n![Bower version](https://badge.fury.io/bo/ibantools.svg)\n[![npm version](https://badge.fury.io/js/ibantools.svg)](https://badge.fury.io/js/ibantools)\n[![NPM downloads](https://img.shields.io/npm/dw/ibantools)](https://www.npmjs.com/package/ibantools)\n![Dependents (via libraries.io)](https://img.shields.io/librariesio/dependents/npm/ibantools)\n\n![Build CI](https://github.com/Simplify/ibantools/workflows/Build%20CI%20(Master)/badge.svg?branch=master)\n![ESLint \u0026 Prettier CI](https://github.com/Simplify/ibantools/workflows/ESLint%20\u0026%20Prettier/badge.svg?branch=master)\n[![Coverage Status](https://coveralls.io/repos/github/Simplify/ibantools/badge.svg?branch=master)](https://coveralls.io/github/Simplify/ibantools?branch=master)\n\n![GitHub last commit](https://img.shields.io/github/last-commit/Simplify/IBANtools)\n![GitHub contributors](https://img.shields.io/github/contributors/Simplify/IBANTools)\n![GitHub issues](https://img.shields.io/github/issues/Simplify/ibantools)\n![GitHub closed issues](https://img.shields.io/github/issues-closed-raw/Simplify/ibantools)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/Simplify/ibantools)\n![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/Simplify/IBANTools)\n\n![No deps](https://img.shields.io/badge/dependencies-0-brightgreen)\n![dev deps](https://img.shields.io/librariesio/github/Simplify/IBANTools?label=devDependencies)\n\n## About\n\nIBANTools is TypeScript/JavaScript library for validation, creation and extraction of IBAN, BBAN and BIC/SWIFT numbers.\n\nFor more information about IBAN/BBAN see [wikipedia page](https://en.wikipedia.org/wiki/International_Bank_Account_Number) and\n[IBAN registry](https://www.swift.com/resource/iban-registry-pdf).\n\nFor more information about BIC/SWIFT see [this wikipedia page](https://en.wikipedia.org/wiki/ISO_9362).\n\n## Installation\n\n### Node (Common JS ES5 and ES6)\n\n```\n$ npm install ibantools\n```\n\n### Bower (AMD ES5)\n\n```\n$ bower install ibantools\n```\n\n## Usage\n\nSee [full documentation](http://simplify.github.io/ibantools) with examples on Github pages.\n\n### Node.js - CommonJS\n\n```js\nconst ibantools = require('ibantools');\nconst iban = electronicFormatIBAN('NL91 ABNA 0417 1643 00'); // 'NL91ABNA0517164300'\nibantools.isValidIBAN(iban);\n\n// If you want to know reason why IBAN is invalid\nibantools.validateIBAN('NL91ABNA0517164300');\n// Returns { valid: false, errorCodes: [iban.ValidationErrorsIBAN.WrongIBANChecksum] }\n\n// Validate BIC\nibantools.isValidBIC('ABNANL2A');\n```\n\n### AMD - RequireJS - Browser\n\n```js\nrequire([\"ibantools\"], function(ibantools) {\n  console.log(ibantools.isValidIBAN('NL91 ABNA 0417 1643 00'));\n  console.log(ibantools.isValidBIC('ABNANL2A'));\n});\n```\n\n### Node.js - Common JS in browser\n\nUse browserify or webpack.\n\n### jsnext:main\n\nUse node, not bower module.\n\nIf you are using tools that support `jsnext`, like a [rollup](https://github.com/rollup/rollup) or [JSPM](http://jspm.io/), they will automatically select right module from the package.\n\n### With TypeScript\n\nInstall library/module using npm. Package bundles type definitions and if you are on TypeScript 2.0 or above `tsc` will access those automatically. If not, check your `tsconfig.json` file.\n\n### Extension\n\nCountry specifications can be extended with national BBAN validations by calling `setCountryBBANValidation`.\n\nFor example, to fully syntactically check German IBAN, you can install [IBANTools-Germany](https://github.com/baumerdev/ibantools-germany) and add this with\n\n```\nconst ibantools = require('ibantools');\nconst ibantoolsGermany = require(\"ibantools-germany\");\nibantools.setCountryBBANValidation(\"DE\", ibantoolsGermany.isValidBBAN);\n```\n\n## Contributing\n\nThis project adheres to the Contributor Covenant [code of conduct](https://github.com/Simplify/ibantools/blob/master/.github/CODE_OF_CONDUCT.md).\nBy participating, you are expected to uphold this code.\n\nFor contribution details, please read [this document](https://github.com/Simplify/ibantools/blob/master/CONTRIBUTING.md).\n\n## License\n\nThis work is dual-licensed under MIT and MPL-2.0.\nYou can choose between one of them if you use this work.\n\n`SPDX-License-Identifier: MIT OR MPL-2.0`\n\n","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimplify%2Fibantools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSimplify%2Fibantools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimplify%2Fibantools/lists"}