API Reference

Treasury

Accounts, expected payments, and returns.

GET/v1/accountsList accounts

Returns all accounts with available and pending balances. Every balance movement is attributable to a payment, return, or conversion.

GET/v1/accounts/{id}Retrieve an account

POST/v1/expected_paymentsCreate an expected payment

Declares an incoming payment for automatic matching on arrival.

Parameter	Type	Required	Description
`account`	string	yes	Receiving account, `oz_acct_`
`amount`	object	yes	`value`, `currency`, optional `tolerance` (fraction)
`counterparty_name`	string	yes	Expected sender
`reference`	string	yes	Invoice reference to match against
`expires_at`	string	no	RFC 3339; unmatched declarations expire

GET/v1/expected_paymentsList expected payments

Query parameters: status (open, matched, expired), account, limit, cursor.

GET/v1/returns/{id}Retrieve a return

GET/v1/returnsList returns

Returns reference their original payment. Lifecycle events: return.created, return.settled, return.returned.