Reading MT940 files using Python

Some time ago I wrote a library to read MT940 files with Python. While there are multiple libraries available for this target, none of the others really work properly and/or support all variants of the format.

The MT940 library I wrote is slightly different, it’s designed to be able to parse any MT940 file, regardless whether it’s correct or complete. The initial version of the library was very strict and only supported files that perfectly followed the standards, a few months after the release it became obvious that most banks either used different standards when implementing the standard or interpreted the standard different. Regardless, the library gave little to no results or even crashed on some MT940 files.

Upon reflection I rewrote nearly all of the code to have a script that is flexible enough to support any format (even supporting custom processors for specific format) and wrote test code that tested every MT940 file I could find on the web. The result… a library that parsers pretty much everything out there while still maintaining a reasonable amount of results.

Usage? As simple as you might imagine. After installing (pip install mt-940, note the dash) usage can be as simple as this:
[python]import mt940
import pprint

transactions = mt940.parse(‘tests/jejik/abnamro.sta’)

print ‘Transactions:’
print transactions

for transaction in transactions:
print ‘Transaction: ‘, transaction

For more examples, have a look at the tests. For example, the preprocessor test:
[python]import pytest
import mt940

def sta_data():
with open(‘tests/jejik/abnamro.sta’) as fh:

def test_pre_processor(sta_data):
transactions = mt940.models.Transactions(processors=dict(

assert[‘closing_balance’].amount.currency == ‘USD’
assert[‘opening_balance’].amount.currency == ‘EUR’

def test_post_processor(sta_data):
transactions = mt940.models.Transactions(processors=dict(

assert ‘closing_balance_day’ not in

Bookmark and Share


About Rick van Hattem

Rick van Hattem is a Dutch Internet entrepreneur and co-founder of

8 Responses to “Reading MT940 files using Python”

  1. Roel Dijkema | 2016-03-11 at 12:12:48 #

    Hello Rick,
    I am trying to understand your MT940 Library. I ran your testprogram. I have trouble to extract data. The most important one: opening balance. Without that I can not check my data input. It does not show up in your test program. I am not afraid to hack a bit, but I do not get into your program. What are you doing ? How does it work ? Please, enlighten me.
    Kind regards,
    Roel Dijkema

  2. Ben Konrath | 2016-04-16 at 17:58:59 #

    Hi Roel, This pull request should help you get the final opening balance on each transaction which what I think you’re looking for.
    – Ben

  3. R.John | 2018-03-14 at 10:52:02 #

    Hi Rick,
    Thanks to this post. Could you elaborate the code bit more to get the output as a valid json format?

    • Rick van Hattem | 2018-03-14 at 13:11:26 #

      There’s no built-in way but it’s easy enough to write a json encoder:
      import json
      import mt940

      transactions = mt940.parse(‘tests/jejik/abnamro.sta’)

      def default(value):
      if isinstance(value, mt940.models.Transactions):
      data =
      data[‘transactions’] = value.transactions
      return data

      elif hasattr(value, ‘data’):

      print(json.dumps(transactions, default=default, indent=4))

  4. Adam | 2020-07-27 at 17:03:29 #

    With this code,

    import mt940
    import pprint

    transactions = mt940.parse(‘1591139129348.STA’, processors=dict(

    for transaction in transactions:
    # pprint.pprint(
    # pprint.pprint(transactions.post_transaction_details)

    I get this error message.

    Traceback (most recent call last):
    File “./”, line 17, in
    AttributeError: ‘dict’ object has no attribute ‘post_transaction_details’

    How do I get at the stuff generated by



  5. Zizi | 2022-06-20 at 14:26:28 #

    Hi. I’m trying to convert my MT940 from citiban( it is .txt file) to excel or csv file. But I’m a beginner for python and I’m struggling with reading the code you wrote, may I ask if I could message you more about the code? thanks in advance.

  6. Nik | 2024-02-05 at 08:37:05 #

    Hi Rick, i am trying to parse a BankingCircle files with your library but for many cases it fails to get the right data[‘bank_reference’]. it seems it breaks it in half. Is there a way that I can get for each transaction the whole 61 tag?

Leave a Reply