Bank Statement Converter API

Convert bank statements to JSON or CSV from your own software. API access comes with any StatementPro.ai credit pack, and each conversion is paid for with purchased credits at the web app’s rate: 1 credit per 10 pages, rounded up.

Prefer to work in an AI assistant? The same credit pack connects StatementPro.ai to Claude and ChatGPT. See the MCP server →

How it works

What the API does

The StatementPro.ai API is a REST API. You send a bank statement file, StatementPro.ai converts it, and you download the transactions in a format your code can read.

Upload the statement

Request an upload link, then send a PDF, PNG or JPEG of up to 25 MB. Uploading costs nothing.

Start the conversion

One call starts the job. The pages are counted and the credits charged at this step, and the response tells you both.

Get the result

Poll the job for its status. You can also configure signed webhooks as best-effort notifications, then download the result as JSON or CSV.

Each job converts one file. To convert several statements, start one job per file.

Access

Who gets API access

Any account that has bought a credit pack can create an API key. The pack size doesn’t matter: the 10-credit pack unlocks the same API as the 100-credit pack.

  1. Sign up for a free StatementPro.ai account.
  2. Buy any credit pack. Packs start at $5 for 10 credits.
  3. Open Settings, find the API access card and click Create API key. The full key is shown once, so copy it and store it somewhere safe. Full steps: Create an API key

API access doesn’t expire. If your purchased credits run out or expire, your key still works for checking jobs and downloading results. New conversions start again when you buy another pack.

Each account has one active key. You can regenerate or revoke it at any time in Settings. Keep it on your server, not in browser or mobile code.

The 5 free credits that come with a new account are for the web app. The API doesn’t use them.

Credits and limits

What a conversion costs

1 credit per 10 pages

Each conversion costs 1 purchased credit per 10 pages, rounded up, the same rate as the web app. A 4-page statement costs 1 credit; a 23-page statement costs 3. An image counts as one page.

Quote first, if you want

Add "quote": true to see the pages and credits before anything is charged, then start the conversion with the quote. Without a quote, credits are charged when the conversion starts. If your balance is too low, nothing is charged and the response tells you how many credits the statement needs.

Failed jobs are refunded

If a conversion fails, its credits are returned to your balance automatically.

Valid for 12 months

Purchased credits are valid for 12 months from purchase. The oldest credits are used first.

Files

PDF, PNG or JPEG, up to 25 MB, one file per job.

Rate limit

60 requests per minute per key (subject to change). Response headers show how many requests you have left.

Output

JSON or CSV output

JSON

The file name, page count, bank and statement period, then one entry per account on the statement. Each account has a balance summary and its transactions: date, description, amount, running balance, and whether it is a debit or a credit. Amounts are decimal strings with two places, and dates are YYYY-MM-DD.

CSV

One row per transaction, with the columns Bank Name, Statement Period, Account Number, Date, Description, Debits, Credits and Balance.

Excel, QuickBooks and Xero files are downloads in the web app. The API returns JSON or CSV.

Some values, such as the opening balance and the totals, can be worked out from the statement’s transactions rather than read off the page. Check them against the statement before you import them into your books.

Example

Converting one statement, step by step

Here is what converting a 4-page PDF statement looks like. API requests go to https://statementpro.ai/v1 with your key in the Authorization header. Send the file itself to the upload URL returned by POST /v1/uploads, without your API key.

  1. Ask for an upload link. Send POST /v1/uploads with the file name and type. You get back an uploadId and an upload link that is valid for 15 minutes.
  2. Upload the file. PUT the PDF to that link.
  3. Start the conversion. Send POST /v1/convert with the uploadId and an Idempotency-Key, so a retried request isn’t charged twice. The reply says the job is queued, the statement has 4 pages and 1 credit was charged.
  4. Wait for it to finish. Poll GET /v1/jobs/{id} until the status is completed or failed. A signed job.completed or job.failed webhook may notify you; delivery is best effort.
  5. Download the result. GET /v1/jobs/{id}/result?format=csv returns one row per transaction. Use format=json for the full structure.
POST https://statementpro.ai/v1/convert
Authorization: Bearer sp_live_your_key_here
Content-Type: application/json
Idempotency-Key: 0b9d4d52-6a0e-4b38-9a43-5c1f3e2d7a10

{"uploadId": "3f6c2a8e-5b1d-4c7a-9e2f-8a4b6d0c1e93"}
202 Accepted

{
  "id": "3f6c2a8e-5b1d-4c7a-9e2f-8a4b6d0c1e93",
  "status": "queued",
  "pageCount": 4,
  "creditsCharged": 1,
  "createdAt": "2026-11-02T15:00:12Z"
}

The full reference, with complete examples in cURL, Python and Node.js, is in the API documentation.

For AI assistants

Use the API From Claude, ChatGPT or Your Code Editor

Our MCP server puts the API inside AI assistants. Claude and ChatGPT connect to it by URL and you approve the connection on statementpro.ai. Claude Code, Cursor and VS Code run our npm package, @statementpro/mcp, with your API key. Your assistant quotes each statement, converts after you agree and returns the transactions as CSV or JSON.

Bank Statement API — Frequently Asked Questions

Who can use the StatementPro.ai API? +

Any account that has bought a credit pack, of any size. You create your key in Settings, on the API access card. An account that has only its free credits can create a key once it buys a pack.

How much does an API conversion cost? +

1 purchased credit per 10 pages, rounded up, the same rate as the web app. Packs start at $5 for 10 credits. API access itself has no extra charge.

Does the API use my free credits? +

No. API conversions use purchased credits only. The 5 free credits that come with a new account are for the web app.

What happens when my credits run out? +

Your key keeps working, and API access doesn’t expire. You can still check jobs and download results. New conversions return an insufficient-credits error and charge nothing until you buy another pack. Purchased credits are valid for 12 months.

What files and formats does the API support? +

You can send a PDF, PNG or JPEG of up to 25 MB, one file per job. Results come back as JSON or CSV. Excel, QuickBooks and Xero files are downloads in the web app.

Can I convert several statements at once? +

Each job converts one file. To convert several statements, start one job per file and stay within the rate limit of 60 requests per minute per key (subject to change).

How do I know when a conversion has finished? +

Check the job with GET /v1/jobs/{id}. You can also configure a signed job.completed or job.failed webhook in Settings. Webhook delivery is best effort, so poll for jobs you have not heard about.

What happens if a conversion fails? +

Its credits are returned to your balance automatically, and the job shows creditReturned: true once they are back.

Is there an SDK or OpenAPI specification? +

There is no SDK or OpenAPI specification. The API uses plain HTTPS with JSON requests and responses, and the API documentation has complete examples in cURL, Python and Node.js. If you work in an AI assistant or code editor, our MCP server (npm package @statementpro/mcp) wraps the API for you.

Can I use the API from Claude or ChatGPT? +

Yes, through our MCP server. Claude and ChatGPT connect to https://statementpro.ai/v1/mcp and you approve the connection on statementpro.ai. Claude Code, Cursor and VS Code use the npm package with your API key. It spends the same purchased credits as the API.

The technology

The platform behind the API

StatementPro.ai, including its API, runs on SortSpoke's document AI platform, built by the same company, Mocsy Inc.

Create Your API Key

Sign up free, buy any credit pack, then create your key in Settings. Packs start at $5 for 10 credits, and the API uses purchased credits at 1 credit per 10 pages.

Get Started Free View Credit Packs