Get account balance

GET https://app.speybooks.com/api/v1/accounts/{id}/balance

Returns the current balance for an account, calculated from all posted transaction lines. The response includes total debits, total credits, and the net balance — all in minor units (pence).

Only posted transactions are included; draft transactions are excluded from the balance calculation.

Path parameters

id string required
Prefixed account ID (e.g. acc_1200).

Response

200 Returns the current balance for the account, calculated from posted transaction lines. All amounts in pence (minor units).
Show response fields
account object
Summary of the account.
Show child attributes
accountType string
Account type.
code string
Account code.
id string
Prefixed account ID (e.g. acc_1200).
name string
Account display name.
balance object
Balance breakdown from posted transactions.
Show child attributes
credit integer
Total credit amount in pence (minor units).
debit integer
Total debit amount in pence (minor units).
net integer
Net balance in pence (minor units). Debit minus credit.

Error codes

400 Invalid ID format.
404 Account not found.