MT940 for Python

Read bank statement text into transactions, decimal amounts, dates and balances. mt940 has no runtime dependencies and includes type information for Python 3.10 through 3.15.

Parse a first statement

Parse your first statement uses a complete fictional statement, then reads its transaction and closing balance. No bank file or checkout is needed.

Keep statement metadata

Keep separate statements and group transactions explains merged files, separate :20: blocks and transaction grouping within a statement.

Adapt a bank export

Customise tags and ordered processors builds isolated tag overrides and ordered processors. Choose compatibility options explains all ten opt-in switches.

Ship an integration

Export a statement to JSON follows a synthetic file through validation, reconciliation and a JSON report. Diagnose unexpected output diagnoses common surprises.

The parser preserves the values it recognises. It does not verify a bank's signature, calculate balances or guarantee that an export is complete. Your application decides which fields and reconciliation checks it requires.

Start here

• Installation
• Parse your first statement
• Choose a parsing workflow

Guides

• Read files, text and streams
• Read transactions, amounts and balances
• Keep separate statements and group transactions
• Export a statement to JSON
• Customise tags and ordered processors
• Bank formats and field reference
• Choose compatibility options
• Diagnose unexpected output

Reference

• API reference
• Trace the parser pipeline

Contributing

• Contributing
• Run tests and maintain fixtures
• Build and maintain the documentation
• Verify a release

Project

• Support this project

Find a symbol through Index, browse Module Index, or use Search Page. Source and issue reports live on GitHub.