# QBO Maker Convert API

_Canonical: https://qbomaker.com/api.html_

Turn transaction data into QuickBooks .QBO, Quicken .QFX or generic .OFX files from your own
scripts, integrations, or AI agents. The browser converter is free and client-side. The hosted
Convert API is part of Pro ($29/mo). The /validate endpoint is free and open.

Base URL: https://api.qbomaker.com
OpenAPI: https://qbomaker.com/api/openapi.json
MCP server card: https://qbomaker.com/.well-known/mcp-server-card.json

## Authentication
Authenticate /convert with your Pro key as a Bearer token:
Authorization: Bearer QBOM-PLUS-XXXX-XXXX-XXXX

## Endpoints
- POST /convert  (Pro key)  Convert transactions to .QBO/.QFX/.OFX/CSV
- POST /validate (public)    Check a file before importing
- POST /mcp      (key for convert)  MCP JSON-RPC: initialize, tools/list, tools/call

## Convert example
POST /convert with JSON:
{
  "format": "qbo",
  "accountType": "CHECKING",
  "bankId": "021000021",
  "transactions": [
    { "date": "01/05/2024", "amount": -42.50, "description": "Coffee Shop" },
    { "date": "01/06/2024", "amount": 2000.00, "description": "Payroll" }
  ]
}
Response: { "format": "qbo", "transactions": 2, "skipped": 0, "inputCount": 2, "valid": true, "issues": [], "file": "OFXHEADER:100..." }
(transactions = rows emitted; skipped = rows dropped for an unreadable date/amount; inputCount = total sent.)
Pass "responseType": "file" to receive the raw file as a download (skipped rows are reported in the X-Skipped-Transactions header).
Errors: JSON { "error": "..." } with status 400 (bad request), 401 (missing/invalid Pro key), or 413 (over 100000 transactions).

Request fields: transactions (required array of {date, amount, description, optional memo,
checkNumber}, max 100000); format (qbo|qfx|ofx|csv); currency (3-letter ISO, default USD);
accountType (CHECKING|SAVINGS|CREDITCARD|MONEYMRKT); bankId (routing number); accountId;
responseType (json|file).

## Validate example
POST /validate with { "content": "OFXHEADER:100..." } returns structural checks, transaction
count, and duplicate-ID detection.

## MCP
The API is also an MCP server. Point your MCP client at https://api.qbomaker.com/mcp. Tools:
convert_transactions_to_qbo and validate_ofx.

Not affiliated with Intuit, QuickBooks or Quicken.