maybankpdf2json

Convert Maybank PDF statements into structured data.

TL;DR

• Use one method: json()
• Output includes: account_number, statement_date, transactions

Install

pip install maybankpdf2json

Usage

from maybankpdf2json import MaybankPdf2Json

with open("statement.pdf", "rb") as f:
  data = MaybankPdf2Json(f, "your_pdf_password").json()  # No password? Omit the second argument.

print(data)

Example output:

{
  "account_number": "162021-851156",
  "statement_date": "30/09/24",
  "transactions": [
    {
      "date": "01/09/24",
      "desc": "BEGINNING BALANCE",
      "trans": 0,
      "bal": 3285.77
    }
  ]
}

Response Schema

Root Object

Field	Type	Format	Notes
account_number	str | None	NNNNNN-NNNNNN	May be None if not detected
statement_date	str | None	dd/mm/yy	May be None if not detected
transactions	list[Transaction]	Array	Ordered as parsed from statement

Transaction Object

Field	Type	Format	Example
date	str	dd/mm/yy	01/09/24
desc	str	Free text	BEGINNING BALANCE
trans	float | int	Signed numeric	-10.0, 0, 250.5
bal	float	Signed numeric	3285.77

Date format is dd/mm/yy.

Quick Full-Data Test (tests folder)

1. Put your statement PDF at tests/test.pdf.
2. Run this from the project root:

TEST_PDF_PASSWORD='passwordOfTest.pdf' python3 -c "import json, os; from maybankpdf2json.extractor import MaybankPdf2Json; f=open('tests/test.pdf','rb'); print(json.dumps(MaybankPdf2Json(f, os.environ.get('TEST_PDF_PASSWORD','')).json(), indent=2)); f.close()"

If your PDF has no password, use TEST_PDF_PASSWORD=''.

MIT License.