API Reference

Reconciliations

Start a bank reconciliation draft for an account statement period, then complete it to mark reviewed journal entries as reconciled.

Last updated 2026-07-28

The Reconciliations API creates a draft reconciliation for a bank/cash account statement period and completes it once the ending balance is verified.

Completing a reconciliation is the only Partner API way to set `reconciled: true` on transactions/journal entries — there is no direct writable field for it.

Key concepts

Create then complete

POST /partners/reconciliations creates a DRAFT. PATCH /partners/reconciliations/{uuid}/complete locks it and stamps reviewed journal entries in the period as reconciled.

Opening balance is automatic

The opening balance is taken from the account’s last completed reconciliation. You only supply endingBalanceDate and endingBalanceAmount.

Date ordering

Reconciliations must complete in date order. Create rejects if a draft/completed reconciliation already exists for that date, or if a later completed reconciliation already exists for the account.

autoReconcile

On complete, `autoReconcile: true` also marks unreviewed entries in the period as reviewed and reconciles them. Defaults to false — only what a human already reviewed.

The reconciliation object

Draft or completed reconciliation for one account and statement ending date.

Attributes

iduuid

Reconciliation UUID. Pass to complete.

accountUuiduuid

Account UUID from the chart of accounts (bank/cash account).

endingBalanceDatedate

Statement ending date (YYYY-MM-DD).

endingBalanceAmountnumber

Statement ending balance.

statusstring

Typically draft until completed.

Example

{
  "id": "778899aa-bbcc-ddee-ff00-112233445566",
  "accountUuid": "c8d9e0f1-a2b3-4567-cdef-789012345678",
  "endingBalanceDate": "2026-03-31",
  "endingBalanceAmount": 12500.45,
  "status": "draft"
}

Closed books

Complete rejects with 400 if the ending balance date falls in a book-closed sealed period.

MCP equivalents

COUNT_create_reconciliation and COUNT_complete_reconciliation.

Recent changes

2026-07-28

Connections, reconciliations, opening balance, workspace cutover, and transaction bulk ops

Documented Partner API groups for bank Connections (including Plaid Hosted Link connect/complete/reconnect), Reconciliations (create draft + complete), Opening Balance (get/set conversion balance), and Workspace (PATCH cutoverDate). Added PATCH /partners/transactions/change-category-bulk and exclude-bulk. Removed non-existent POST /partners/bills/bulk and /partners/invoices/bulk from the reference. Extended the MCP tool catalog with the matching COUNT_* tools plus remote-only COUNT_get_bulk_task_status and COUNT_remember/recall/forget.

Endpoints

POST

Create a reconciliation/partners/reconciliations

Creates a draft reconciliation for an account statement period.

PATCH

Complete a reconciliation/partners/reconciliations/{uuid}/complete

Locks a draft reconciliation and marks reviewed journal entries reconciled.

Overview