API reference

Reconciliations

An account's balance held against its statement.

GET/v1/reconciliationsList an account's reconciliations
POST/v1/reconciliationsReconcile an account against its statement

List an account's reconciliations

GET/v1/reconciliations

client.reconciliations.list()

Every comparison of an account against a statement, newest first: the two balances, the difference and whether they agreed. An attempt is never edited; a later one for the same date stands in its place and both stay.

Parameters

Name	Type	Description
`limit`Query	integer	Page size, 1–200. Default 50
`cursor`Query	string or null	The `next_cursor` of the previous page.
`account_id`Query	string or null	An id that starts with `gla_`.

Response

200ReconciliationPage

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/reconciliations" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Reconcile an account against its statement

POST/v1/reconciliations· Idempotent

client.reconciliations.create()

Compare an account against a statement figure, and record the result.

A difference raises an exception that blocks the close. That is the point: it is the only check in the system that can catch a transaction the ledger never saw.

Request body

ReconcileRequest

Response

201ReconcileResponse

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl -X POST "https://api.ledgerit.ai/v1/reconciliations" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"…","as_of":"2026-09-30","statement_balance":0}'

Objects

The objects these operations take and return.

ReconciliationPage

Name	Type	Description
`data`Required	array of ReconciliationOut
`has_more`Required	boolean
`next_cursor`Required	string or null

ReconcileRequest

Name	Type	Description
`account_id`Required	string	An id that starts with `gla_`.
`as_of`Required	string (date)
`include_descendants`	boolean	Default false
`statement_balance`Required	number \| string

ReconcileResponse

Name	Type	Description
`account_id`Required	string	An id that starts with `gla_`.
`as_of`Required	string (date)
`difference`Required	string
`is_balanced`Required	boolean
`ledger_balance`Required	string
`statement_balance`Required	string

ReconciliationOut

One time an account was compared against a statement, and what it found.

Name	Type	Description
`account_code`Required	string
`account_id`Required	string	An id that starts with `gla_`.
`account_name`Required	string
`as_of`Required	string (date)	The date the statement balance is as of.
`by_person`Required	boolean	True when a person entered the statement balance; false when a month's close compared against the balance a connected source reported.
`created_at`Required	string (date-time)
`difference`Required	string	Statement less ledger; zero when they agree.
`id`Required	string	An id that starts with `recon_`.
`includes_descendants`Required	boolean	Whether the comparison covered the account and every account under it.
`is_balanced`Required	boolean
`ledger_balance`Required	string	What the ledger held on that date.
`statement_balance`Required	string