API Documentation

Integrate bank statement analysis into your application. All endpoints accept file uploads via FormData and authenticate with API keys.

API Keys

Include your API key in the Authorization header:

Authorization: Bearer mbsa_...

API usage counts against your plan's page limit:

Free3 pages/month

Basic ($9/mo)500 pages/month

Pro ($19/mo)Unlimited

When rate limited, responses return 429 with { limitReached: true }

POST/api/analyze

Upload a bank statement PDF or image. Returns a redirect to the results page, or use the analysis ID from the Location header.

FormData with "file" field (PDF, JPG, PNG — max 10MB)

302 redirect to /results/{id}, or JSON { error } on failure

curl -X POST https://mybankstatementanalysis.com/api/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@statement.pdf"

1Create an API key above

2Add it to your Authorization header as a Bearer token

3Upload a bank statement PDF to any endpoint via FormData

4Parse the JSON response or download the file

FormatsPDF, JPG, PNG

Max size10 MB per file

Upload field"file" in multipart FormData

Multi-fileSupported for analyze and export endpoints

400Bad request — missing file, invalid format, or file too large

401Unauthorized — missing or invalid API key

403Forbidden — feature requires a higher plan

422No transactions found in the uploaded document

429Rate limit exceeded — upgrade your plan

500Server error — retry or contact support