IBAN in Python

Overview

schwifty validates the check digits and the country-specific format of an IBAN, as well as the format and country code of a BIC. It can also generate a BIC from a country and a bank code, generate an IBAN from a country, bank code and account number, and produce random valid IBANs.

It looks up the BIC associated with an IBAN’s bank code and exposes all components as attributes. Because the IBAN specification and the mapping from BIC to bank code are updated from time to time, the project uses CalVer versioning with the scheme YY.0M.Micro. It installs with pip and is released under the MIT license.

Highlights

• Validation of the check digits and country-specific format of an IBAN.
• Validation of the format and country codes of a BIC.
• Generation of BICs (country and bank code), IBANs (country, bank code, account number) and random valid IBANs.
• Lookup of the BIC associated with an IBAN’s bank code and access to components as attributes.
• CalVer versioning (YY.0M.Micro) and documentation hosted on Read the Docs.

Who it is for

For Python developers who need to check or produce IBANs and BICs, for example in a tool that prepares international money transfers.

Installation

Install with pip from PyPI. Validation and generation examples are linked in the Read the Docs documentation.

pip install schwifty

Read the README on GitHub

Points of attention

• The version number follows the date (CalVer YY.0M.Micro), because the IBAN specification and the BIC / bank code mapping are updated from time to time.
• The repository’s pyproject.toml declares Python 3.11 or later; the README does not mention this requirement.

Can an agent use it?

AGENTS.md is an orientation guide for agents working on the schwifty code (commands, vocabulary, design decisions). No SKILL.md or MCP server found: this is a Python library.