Build a REST API for a Credit Card Statement Parser

Take-Home Assignment

Build a REST API that parses and analyses credit card statements (CSV/PDF input) and exposes structured endpoints.

Requirements

• POST /upload — accept statement file, parse transactions
• GET /transactions?month=&category= — filtered transaction list
• GET /summary — total spend, top categories, largest transaction
• Auto-categorise transactions (groceries, travel, dining, etc.) using merchant name heuristics

Evaluation criteria

• Clean project structure and README
• Input validation and error handling
• Unit tests with reasonable coverage
• API design quality (status codes, response shapes)
• Bonus: pagination, async processing for large files
• Creativity in categorisation logic, thoughtful edge-case handling (duplicate transactions, multi-currency), and code that reads like documentation