API Documentation

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

API Keys

Sign in to manage API keys

Sign in

Authentication

Include your API key in the Authorization header:

Authorization: Bearer mbsa_...

Rate Limits

API usage counts against your plan's page limit. Some tools also have separate daily caps.

Free1 page/month
Basic ($9/mo)500 pages/month
Pro ($19/mo)Unlimited

When rate limited, responses include { limitReached: true } with status 402 or 429 depending on plan and endpoint.

Analyze Statement

POST/api/analyze

Upload a bank statement PDF or image. Returns the created analysis ID as JSON.

Request Body

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

Response

{ id: string }

Example

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

Quick Start

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

File Requirements

FormatsPDF, JPG, PNG
Max size10 MB per file
Upload field"file" in multipart FormData
Multi-fileSupported for analyze and export endpoints

Error Codes

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