Skip to content
betterbooks.

BETTERBOOKS / DEVELOPERS

Reading accounting data from the BetterBooks API

Reading accounting data from the BetterBooks API means paginating complete populations, keeping transaction and base currency apart, and treating write operations with their own contracts.

Read accounts

GET /api/v1/accounts returns a paginated account collection. Follow the deployed AccountFilter schema for filters. The result includes items, totalCount, page and pageSize; the first page is not the complete chart of accounts.

Preserve meaning

Keep transaction currency separate from base currency. Preserve decimal precision and distinguish missing evidence from zero. Retain posting dates, document dates and source references rather than treating them as interchangeable.

Treat mutations carefully

Write operations have endpoint-specific permissions, validation, concurrency and retry contracts. Do not blindly retry financial mutations or assume a timeout means nothing committed. Inspect the operation-specific contract before implementing writes.

GET /api/v1/accounts?page=1&pageSize=50
Authorization: Bearer <authorized-access-token>
X-Book-Id: <authorized-book-uuid>