API Documentation Business plan

Authentication

Generate a key on the API Keys page, then send it as a Bearer token on every request.

Authorization: Bearer sk_live_xxx

Convert a statement

Send multipart/form-data with a file field (PDF, PNG, JPG, WEBP), up to 20MB and 50 pages. Optional format: json (default), csv, xlsx, qbo, ofx.

curl -X POST https://statementflow.io/api/v1/convert \
  -H "Authorization: Bearer sk_live_xxx" \
  -F "file=@statement.pdf" \
  -F "format=json"

Response (format=json):

{
  "success": true,
  "meta": { "bankName": "Chase Bank", "currency": "USD",
            "pageCount": 3, "rowCount": 47,
            "reconciled": true, "processingMs": 2340 },
  "transactions": [
    { "date": "2026-10-02", "description": "Starbucks #1042",
      "amount": -4.50, "balance": 65.73,
      "category": "FOOD", "confidence": 0.98 }
  ]
}

Any other format streams the file back with a content-disposition attachment header rather than JSON.

Usage

Returns your current quota for the billing cycle.

{ "success": true, "plan": "BUSINESS",
  "pagesUsed": 320, "pagesLimit": 2000,
  "pagesResetAt": "2027-01-01T00:00:00Z" }

Rate limits

100 requests/hour per API key. Conversions also count against your monthly page quota (2,000 on Business), which refreshes each billing period — see pricing.

Error codes

Every error returns { success: false, error, message } with the status below.