mt-940

What it is and what it does

This is a parser for MT940 bank statement files—a SWIFT standard format used by banks worldwide to exchange transaction data. It reads these files and returns fully typed Python collections where transactions, amounts, balances, and dates are rich objects rather than raw strings, making them immediately usable for aggregation, filtering, and analysis.

The library has no runtime dependencies and includes type information (py.typed), so it works cleanly in typed codebases. It handles quirks from many real banks through a combination of sensible defaults and opt-in extensions: you can parse a standard statement with a single call, but for banks with non-standard tag layouts, you can register custom tag handlers. It also supports multiple statements in one file, JSON serialization, and custom transaction grouping rules.

Use it for:

• Extract and reconcile bank transactions from MT940 files into a Python application for accounting or bookkeeping.
• Aggregate statement-level data like opening and closing balances across multiple bank files for financial reporting.
• Serialize parsed statements to JSON for downstream processing, APIs, or storage in a data pipeline.
• Handle bank-specific MT940 variants by registering opt-in tags without forking the parser.
• Build transaction analysis tools that work with typed amount and date objects instead of parsing strings manually.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parses MT940 bank statement files into fully typed Python collections with smart models for amounts, balances, and dates, supporting multiple banks and real-world format quirks.

Yes. Actively maintained, zero runtime dependencies, ships with full type information, and handles a wide range of real-world bank formats. Suitable for any Python project that needs to parse MT940 statements reliably. No known security issues, permissive license, and low install friction make it a straightforward choice.

Install

mt-940 on PyPI

pip install mt-940

uv add mt-940

poetry add mt-940

Installing mt-940

Before you install

Low friction: pure Python with zero runtime dependencies, ships as a wheel, and actively maintained with a recent release 53 days ago.

License in practice

BSD-3-Clause is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install mt-940

import mt940

transactions = mt940.parse('statement.sta')
for transaction in transactions:
    print(transaction.data['date'], transaction.data['amount'])

Requires Python 3.10 or newer.

Verify before relying

• Whether the package handles all real-world bank statement variations without manual intervention beyond opt-in tags.
• Performance characteristics when parsing large statement files or many statements in sequence.

Package facts

Evidence: mt_940-5.0.0-py3-none-any.whl

Keywords: MT940

Tags

More Python Modules packages