Skip to main content
GET
Roll-forward balance reconciliation

Authorizations

X-API-KEY
string
header
required

Authorization method required to allow user to access the api endpoints.

Query Parameters

start_time
string<date-time>
required

Requested period start (ISO 8601).

Example:

"2026-07-01T00:00:00Z"

end_time
string<date-time>
required

Requested period end (ISO 8601).

Example:

"2026-08-01T00:00:00Z"

account_ids
string<uuid>[]
required

Comma-separated account ids (UUIDs) to reconcile. Ids outside the caller's workspace are silently dropped, as is any requested id that does not also match every filter dimension below — the filters narrow this list further, they never expand it. Accepts at most 100 ids; a longer list is rejected with a 400 rather than processed. A non-UUID entry is also rejected with a 400 naming the field, rather than reaching the database (RNG-5847).

Minimum array length: 1
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890,b2c3d4e5-f6a7-8901-bcde-f12345678901"

group_id
string<uuid>

Filter to accounts that belong to this group (account_groups.id). A non-UUID value is rejected with a 400 naming the field (RNG-5847).

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

provider
enum<string>

Filter to accounts held under a connection of this provider.

Available options:
utila,
kraken,
binance,
okx,
bybit,
bitget,
gate,
kucoin,
plaid,
squads,
altitude,
coinbase,
realms,
wise,
safe,
hyperliquid,
cubist,
privy,
dfns,
anchorage,
revolut_business,
turnkey,
fordefi,
coins_ph,
fireblocks,
pave_bank,
copper
Example:

"utila"

network
string

Filter to accounts on this network (e.g. ethereum, solana, stellar).

Example:

"ethereum"

account_type
enum<string>

Filter to accounts of this account type.

Available options:
eoa,
multisig,
contract,
custodian,
exchange,
bank,
defi
Example:

"exchange"

role
string

Filter to accounts tagged with this free-text role.

Example:

"treasury"

connection_id
string<uuid>

Filter to accounts under this connection id. A non-UUID value is rejected with a 400 naming the field (RNG-5847).

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

reporting_currency
string
default:USD

Currency the statement's quantities/USD figures are denominated in. Only 'USD' is supported today — no FX conversion exists yet, so any other value is rejected with a 400. Ships now so downstream consumers see the final request shape ahead of multi-currency support landing. Validated for membership against a known currency set, and bounded to a short length — an unsupported or oversized value is rejected with a message derived from the caller's own input.

Example:

"USD"

show_all
boolean
default:false

Restores every opening/closing balance line and movement to its unfiltered shape, ignoring the workspace token whitelist on both sides of the identity. Never mutates stored overrides.

Response

requested_period
object
required
reporting_currency
string
required

Currency every quantity/USD figure in this response is denominated in. Always 'USD' today — echoed back so downstream consumers can rely on the field once multi-currency support lands, without a breaking change (RNG-5665).

Example:

"USD"

items
object[]
required
Last modified on September 3, 2026