Skip to content

Cyberady/bank-statement-converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

15 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏦 Bank Statement Converter API

A production-ready FastAPI backend that converts bank statement PDFs into structured CSV and Excel files with automatic transaction detection and balance-based debit/credit logic.

πŸš€ Live API

https://bank-statement-converter-moih.onrender.com/docs

✨ Features

  • Upload multi-page bank statement PDFs
  • Extract transactions (date, description, amount, balance)
  • Intelligent debit/credit detection using balance logic
  • Generate summary (total credit, total debit, opening & closing balance)
  • Export results as CSV and Excel
  • Supports large statements (200+ transactions)

πŸ›  Tech Stack

  • FastAPI
  • Python
  • pdfplumber
  • Pandas
  • Uvicorn

πŸ“€ API Endpoint

POST /upload

Upload a bank statement PDF and receive:

  • Transaction summary
  • Downloadable CSV & Excel files

πŸ“Š Sample Summary Output

{
  "total_transactions": 283,
  "total_credit": 200664,
  "total_debit": 240011.78,
  "opening_balance": 40149.89,
  "closing_balance": 802.11
}
🧠 Notes
Uses rule-based parsing (no external APIs)

Balance-delta logic ensures accurate debit/credit detection

Designed for extensibility across multiple banks

πŸ“Œ Future Enhancements
Multi-bank format detection

OCR fallback for scanned PDFs

Frontend UI

Authentication & rate limiting

Built with ❀️ by Aditya

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published