Skip to main content
POST
Accounting

Overview

Read-only tools on a connected QuickBooks, Zoho Books or Xero (Connections). Nothing is written at the system; nothing fetched is kept.
  • POST /v1/tools/ledger/invoices (ledger_invoices): invoices you issued.
  • POST /v1/tools/ledger/bills (ledger_bills): bills you owe.
  • POST /v1/tools/ledger/reports (ledger_reports): a balance sheet, profit and loss or trial balance.
All take connection_id: list your connections (GET /v1/connections) and pick by system and account_label. Xero: a page can hold fewer than limit records. A sign-in reaching several organisations reads the one named in account_label.

Authentication

Requires x402 payment in the payment-signature header. Refusals for the body, the connection or an unavailable system come before payment and are not charged.

Invoices and bills

Response (200)

array
Each record: id, number, counterparty (name, id), issued_on, due_on, status (open, paid, overdue, void or draft), currency, total, balance and source (system, id). Missing fields are null.
string
Present when more records exist: send it as cursor.

Reports

QuickBooks and Xero serve all three reports (Xero: a profit and loss of at most 365 days, and currency null). Zoho Books serves the trial balance as of today only.

Response (200)

Errors