Reconciliation
The ledger vs the chain vs the invoices for a period, with every difference explained or flagged
GET /v1/reconciliation
Reconcile a period.
For the invoices created in [from, to) (and the unattributed deposits opened in it), compares three
views of the same money per asset: the ledger entries posted for them, the on-chain transfers, and
the invoices' outcomes. Every difference is listed as a discrepancy, either explained (expected:
still confirming, held for review, refund owed, ...) or flagged (someone should look). Defaults to
the last 30 days; at most 366 days.
Authentication: Secret key
Parameters
| Parameter | In | Type | Description |
|---|---|---|---|
from | query | string | Start (inclusive): |
to | query | string | End (exclusive). Default: now |
asset | query | string | Only this asset, e.g. |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Reconciliation application/json | |
| 400 | ErrorResponse application/json |
GET /v1/reconciliation/balances
Ledger balances as of a date.
For each asset and account group of your ledger: the balance at from, the postings in
[from, to), the balance at to (the balance as of to), and the previous period's movement
(the equally long period ending at from), so a month can be compared with the last. Unlike the
reconciliation report, every journal entry counts by its own date. Defaults to the last 30 days; at
most 366 days.
Authentication: Secret key
Parameters
| Parameter | In | Type | Description |
|---|---|---|---|
from | query | string | Start (inclusive): |
to | query | string | End (exclusive): the balances are as of this moment. Default: now |
asset | query | string | Only this asset, e.g. |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | LedgerBalances application/json | |
| 400 | ErrorResponse application/json |
GET /v1/reconciliation/export
Export a reconciliation as CSV.
The same report as GET /v1/reconciliation, one row per figure and per discrepancy. Columns:
section,asset,item,amount,severity,invoice,network,tx_hash,index,detail. Amounts are decimal
strings; text that a spreadsheet would run as a formula is prefixed with '.
Authentication: Secret key
Parameters
| Parameter | In | Type | Description |
|---|---|---|---|
from | query | string | Start (inclusive), as for the report |
to | query | string | End (exclusive), as for the report |
asset | query | string | Only this asset |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | CSV (RFC 4180, CRLF line ends) | string text/csv |
| 400 | ErrorResponse application/json |