What are the rate limits for the Clear Books API?

Applications making more than 5 requests per second for a sustained period may be throttled with HTTP 429 responses. Retries should use exponential backoff. Limits are not hard-coded and may change without notice, so your client should always honour 429 responses.

Can I create UK VAT-aware invoices through the Clear Books API?

Yes. POST /accounting/sales/{salesType} with salesType=invoice creates an invoice, and the VAT read endpoints expose the VAT settings used for return preparation. Combine with GET /accounting/customers to ensure the customer record exists before raising the invoice.

How do I push bank statements into Clear Books for reconciliation?

Use the bank statements endpoint under the accounting.bank_statements:write scope to push transactions for a given bank account. Combine with GET /accounting/bankAccounts to identify the target account ID. This is the standard pattern when a bank is not covered by Clear Books native feeds.

How do I raise a Clear Books invoice through Jentic?

Install the SDK with pip install jentic, search Jentic for 'create a clear books invoice', load the schema, and execute. Jentic manages the OAuth refresh-token rotation so the agent never holds the long-lived credential, and the single-active-token constraint per user is respected.

How does pagination work on the Clear Books API?

Paginated endpoints accept limit (max 200) and page parameters, and responses include X-Pagination-Limit, X-Pagination-Current-Page, X-Pagination-Total-Pages, and X-Pagination-Total-Count headers. Use the total-pages header to plan a full-table sync without making an extra count call.

Can I limit what my agent is allowed to do with the Clear Books API?

Yes. Because you run Jentic One yourself, your own rules decide exactly which Clear Books operations and credentials your agent may use. Clear Books puts the document type in the URL path, so you can pin the agent to a single type, for example allowing POST /accounting/sales/{salesType} for invoices while withholding supplier creation or bank account reads. Only the operations you explicitly grant are callable, so an agent set up to raise invoices cannot post journals or push bank statements unless you add those.