Practice Manager API
Reconciliations
Start a bank reconciliation draft for an account statement period, correct or delete it while it is a draft, then complete it to mark reviewed journal entries as reconciled.
Last updated 2026-10-03
Overview
The Reconciliations API creates a draft reconciliation for a bank/cash account statement period, lets you correct or delete the draft, 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 /firm-partners/workspace/reconciliations creates a DRAFT. PATCH /firm-partners/workspace/reconciliations/{uuid}/complete locks it and stamps reviewed journal entries in the period as reconciled.
Opening balance is automatic
The earliest open draft opens on the account’s last completed reconciliation, and each later draft opens on the ending balance of the draft before it. You only supply endingBalanceDate and endingBalanceAmount; updating or deleting a draft re-derives the opening balance of every later draft.
Correcting a draft
PATCH /firm-partners/workspace/reconciliations/{uuid} changes the ending date and/or amount of a draft. DELETE /firm-partners/workspace/reconciliations/{uuid} removes a draft so you can create the right one; a draft has reconciled nothing, so no transactions or journal entries change. Completed reconciliations are undone in COUNT, not through the API.
Date ordering
Reconciliations must complete in date order. Create and update reject 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
iduuidReconciliation UUID. Pass to update, delete, or complete.
accountUuiduuidAccount UUID from the chart of accounts (bank/cash account).
endingBalanceDatedateStatement ending date (YYYY-MM-DD).
endingBalanceAmountnumberStatement ending balance.
statusstringTypically draft until completed.
{
"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, COUNT_update_reconciliation, COUNT_delete_reconciliation, and COUNT_complete_reconciliation.Bank statements
Attach a statement to a draft with POST /{uuid}/bank-statement (URL or inline base64) or POST /{uuid}/bank-statement/upload (multipart), up to 25 MB. It is filed in Documents under Bank Statements/{account name}, named for the statement period, and read back with GET /{uuid}/bank-statement/content. `bankStatementUrl` on a reconciliation is a signed link to use straight away.Related
Endpoints
/firm-partners/workspace/reconciliationsCreates a draft reconciliation for an account statement period.
/firm-partners/workspace/reconciliations/{uuid}Corrects the ending date and/or ending balance of a draft reconciliation.
/firm-partners/workspace/reconciliations/{uuid}Deletes a draft reconciliation.
/firm-partners/workspace/reconciliations/{uuid}/completeLocks a draft reconciliation and marks reviewed journal entries reconciled.
/firm-partners/workspace/reconciliations/{uuid}/bank-statementAttaches one bank statement to a draft reconciliation, from a public URL or inline base64 content.
/firm-partners/workspace/reconciliations/{uuid}/bank-statement/uploadAttaches one bank statement to a draft reconciliation via multipart form data.
/firm-partners/workspace/reconciliations/{uuid}/bank-statement/contentReturns a reconciliation's bank statement, base64-encoded.
