---
id: python-stdnum
version: "2.2"
license: LGPL
license_treatment: copyleft
maintenance: active
---

# python-stdnum — Python module to handle standardized numbers and codes

License: copyleft · Maintenance: active · Downloads: 6.2M/mo

## What it is and what it does

python-stdnum is a validation and formatting library for standardized identification and financial numbers used across the world. It handles tax IDs, VAT numbers, bank account identifiers, national identity codes, and other regulated number formats from many countries and regions. The library provides functions to check whether a number is valid according to its format's checksum or structural rules, and to reformat numbers into canonical or display-friendly forms.

The package is designed for developers in finance, insurance, telecommunications, and government sectors who need to validate user input or process international identifiers. It has no external dependencies, installs quickly, and works across modern Python versions. Typical use cases include validating customer tax IDs before submission to authorities, checking IBAN correctness in payment systems, or normalizing identity numbers for database storage.

Use it for:

- Validate a customer's tax ID or VAT number before submitting to a government agency or payment processor.
- Normalize and reformat bank account numbers for consistent storage or display in financial applications.
- Check the structural validity of national identity card numbers during user registration or KYC workflows.
- Parse and validate international business registration numbers in multi-country accounting systems.
- Verify financial security identifiers in trading or portfolio management tools.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Parses, validates, and reformats standard numbers and codes across many countries and industries—tax IDs, bank accounts, identity numbers, VAT codes, and financial identifiers.

Yes. The package is production-stable, actively maintained, has no dependencies, and solves a real problem for any application handling international identifiers or financial codes. The copyleft license is standard for this type of utility and poses no barrier for most commercial use. Install it if you validate or reformat standardized numbers.

## Install

pip install python-stdnum
uv add python-stdnum
poetry add python-stdnum

## Installing python-stdnum

Before you install: Low friction: pure Python wheel with no runtime dependencies. Actively maintained with recent release and steady commit activity. Supports Python 3.8 through 3.14 and PyPy.

License in practice: Licensed under LGPL (copyleft); you may use it freely but must disclose modifications and license derivative works under LGPL if distributed.

Quickstart:

pip install python-stdnum

from stdnum.es import nif
if nif.is_valid('ABC'):
    print(nif.format('ABC'))

Verify before relying:

- Whether validation rules are kept current with real-world regulatory changes across all supported jurisdictions.
- Performance characteristics when validating large batches of numbers.
- Exact count of supported country formats and number types.

## Package facts

- License: LGPL (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 6.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

validate tax id number, parse iban bank account, check vat number format, identity card validation, standardized number parser, international tax identifier, financial code validator, validation, international-identifiers, financial-codes

[View on SkillFed](https://skillfed.io/packages/python-stdnum) · [View on PyPI](https://pypi.org/project/python-stdnum/)