Reconciliations

Reconciliations are used to match and verify financial transactions across different accounts or statements. They help ensure the accuracy of accounting records by confirming that transactions are properly recorded and balanced.

Endpoints

Query Parameters

The GET /reconciliations endpoint supports the following query parameters:

Attributes

Relationships

All relationships are opt-in and must be requested via the with query parameter.

Reconciliation Entry

Example Request

GET /api/v2/reconciliations?client_account_id=7&with=entries,entries.journal_entry_line,created_by

Example Response

{
    "data": [
        {
            "id": 1,
            "created_at": "2023-05-10T12:00:00Z",
            "created_by_id": 1,
            "client_account_id": 7,
            "sequence_number": 1,
            "reconciliation_date": "2023-05-10",
            "entries": [
                {
                    "id": 1,
                    "journal_entry_id": 1,
                    "journal_entry_line_id": 1,
                    "debit": "100.00",
                    "debit_fc": "100.00",
                    "credit": "0.00",
                    "credit_fc": "0.00",
                    "journal_entry_line": {
                        "id": 1,
                        "posting_date": "2023-05-10",
                        "description": "Bank transaction",
                        "account_code": "1920",
                        "account_id": 1,
                        "debit": "100.00",
                        "credit": "0.00"
                    }
                }
            ],
            "created_by": {
                "id": 1,
                "first_name": "John",
                "last_name": "Doe"
            }
        }
    ],
    "meta": {
        "page": 0,
        "pages": 1,
        "per_page": 100,
        "records": 1
    }
}

Create Reconciliation

POST /api/v2/reconciliations

Creates a committed reconciliation matching two or more journal entry lines. The entries relation is included in the response by default.

Request Body

Entry line fields

This endpoint always creates a committed reconciliation (is_draft: false) — is_draft cannot be set through the request body. Draft (proposal) reconciliations are produced only by Snapbooks’ internal automatic-matching pipeline and approved via Update Reconciliation.

Across all entries, local-currency (debit/credit) amounts must balance to zero. If every entry shares one foreign currency and only the local-currency side is unbalanced, an offsetting FX gain/loss (agio) entry is posted automatically; any other imbalance is rejected.

Example Request

{
  "client_account_id": 7,
  "date": "2026-04-10",
  "entry_lines": [
    { "journal_entry_line_id": 101, "debit": "0", "credit": "500.00" },
    { "journal_entry_line_id": 205, "debit": "500.00", "credit": "0" }
  ]
}

Response

Returns the created reconciliation with status 201 Created, including its entries.

{
  "id": 42,
  "created_at": "2026-04-10T09:15:00Z",
  "created_by_id": 7,
  "client_account_id": 7,
  "sequence_number": 12,
  "reconciliation_date": "2026-04-10",
  "is_draft": false,
  "entries": [
    {
      "id": 88,
      "journal_entry_id": 501,
      "journal_entry_line_id": 101,
      "debit": "0.00",
      "debit_fc": "0.00",
      "credit": "500.00",
      "credit_fc": "500.00"
    },
    {
      "id": 89,
      "journal_entry_id": 502,
      "journal_entry_line_id": 205,
      "debit": "500.00",
      "debit_fc": "500.00",
      "credit": "0.00",
      "credit_fc": "0.00"
    }
  ]
}

Error Responses

Update Reconciliation

PATCH /api/v2/reconciliations/{id}

Approves a draft reconciliation, committing it. is_draft is the only mutable field, and only in the draft → committed direction — reopening a committed reconciliation back to draft is rejected. To undo a committed reconciliation, use Delete Reconciliation instead.

Path Parameters

Request Body

Behavior

• If the reconciliation is already committed, the request is a no-op and returns the current state with 200 OK.
• Otherwise, each cited journal entry line is re-checked to confirm it still has enough open amount to absorb the draft’s applied amount. If a cited line (or its journal entry) was cancelled or reconciled elsewhere since the draft was proposed, the stale draft is deleted and the request fails with 409 Conflict.
• On success, the reconciliation is assigned a sequence_number, is_draft becomes false, and the cited journal entry lines and linked documents update their reconciled status — the same effect as Create Reconciliation.

Example Request

{ "is_draft": false }

Response

Returns the updated reconciliation with status 200 OK, including its entries.

Error Responses

Delete Reconciliation

DELETE /api/v2/reconciliations/{id}

Permanently removes a reconciliation. The journal entry lines remain in place — only the reconciliation linkage is dropped.

Response

Returns 204 No Content with an empty body on success.

Error Responses

Notes

• The client_account_id must be one of the eligible client accounts for the authenticated user.
• Reconciliations can only be created, updated, or deleted if they belong to one of the user’s eligible client accounts.
• The entries, entries.journal_entry_line, and created_by relations are opt-in on GET — request them through with. POST and PATCH responses include entries by default.
• All amounts are returned as string representations of decimal numbers.
• All dates are returned in ISO 8601 format.
• The _fc suffix on amount fields represents “foreign currency” amounts.