Get the current Billy organization (sanity check the token, see org settings). READ-ONLY.

Update fields on the organization. WRITE — requires confirm:true. Pass any subset of: { name, registrationNo, vatNo, street, zipcode, city, countryId, email, phone, paymentTermsDays, defaultTaxMode, salesTaxPeriod, isVatExempted, ... }

List invoices. READ-ONLY. Filters: state (draft/approved/paid), contactId, sinceDate, untilDate.

Fetch one invoice including line items. READ-ONLY.

Create a new invoice (default state: draft). WRITE — requires confirm:true. Shape: { contactId, entryDate, currencyId, lines: [{ productId, description, quantity, unitPrice, taxRateId? }], paymentTermsDays?, lineDescription? }

Update an existing invoice. WRITE — requires confirm:true.

Delete a draft invoice. WRITE — requires confirm:true. Approved/paid invoices cannot be deleted.

Approve a draft invoice (draft → approved). WRITE — requires confirm:true. Required before sending or marking paid.

Send an invoice by email via Billy. WRITE — requires confirm:true. Email payload: { to: ['email'], cc?, bcc?, subject?, message?, attachPdf? }

List bills/expenses. READ-ONLY.

Fetch one bill (expense). READ-ONLY.

Create a new bill. WRITE — requires confirm:true. Shape: { contactId, entryDate, currencyId, lines: [{ accountId, description, amount, taxRateId? }] }

Update an existing bill. WRITE — requires confirm:true.

Delete a draft bill. WRITE — requires confirm:true.

Approve a draft bill. WRITE — requires confirm:true.

List contacts. READ-ONLY.

Fetch one contact. READ-ONLY.

Create a new contact. WRITE — requires confirm:true. Shape: { name, isCustomer, isSupplier, countryId, street?, city?, zipcode?, registrationNo?, email?, phone? }

Update an existing contact. WRITE — requires confirm:true.

Delete a contact. WRITE — requires confirm:true. Contacts with associated invoices/bills cannot be deleted.

List contact persons. READ-ONLY.

Create a contact person. WRITE — requires confirm:true. Shape: { contactId, name, email?, phone?, isPrimary? }

List products (your sellable items/services). READ-ONLY.

Fetch one product. READ-ONLY.

Create a product/service. WRITE — requires confirm:true. Shape: { name, productNo?, description?, prices: [{ unitPrice, currencyId }], salesAccountId?, salesTaxRulesetId? }

Update an existing product. WRITE — requires confirm:true.

Delete a product. WRITE — requires confirm:true.

List the chart of accounts. READ-ONLY.

Fetch one account. READ-ONLY.

Create a new account in the chart of accounts. WRITE — requires confirm:true.

Update an existing account. WRITE — requires confirm:true.

List the account-group hierarchy. READ-ONLY.

Fetch one bank account by id. READ-ONLY. (Billy v2 does not support listing all bank accounts — look up the default via billy_whoami.)

Create a bank account in Billy. WRITE — requires confirm:true.

List bank payments (records of money in/out tied to invoices/bills). READ-ONLY.

Create a bank payment. WRITE — requires confirm:true. Used to mark invoices/bills as paid. Shape: { entryDate, cashSide: 'debit'|'credit', cashAmount, cashAccountId, contraAccountId, associations: [{ subjectType, subjectId, amount }] }

List bank statement lines. READ-ONLY. REQUIRES accountId. Default returns UNMATCHED lines (the actionable state).

Fetch one bank line. READ-ONLY.

Reconcile a bank line with an invoice/bill/bank payment. WRITE — requires confirm:true.

Remove a bank-line reconciliation. WRITE — requires confirm:true.

List daybooks. READ-ONLY.

List manual daybook transactions (journal entries). READ-ONLY.

Create a manual journal entry. WRITE — requires confirm:true. Shape: { daybookId, entryDate, description, lines: [{ accountId, side: 'debit'|'credit', amount, taxRateId? }] }

List configured tax rates. READ-ONLY.

List tax rulesets. READ-ONLY.

List MOMS/VAT returns. READ-ONLY.

Fetch one MOMS/VAT return. READ-ONLY.

P&L report. READ-ONLY.

Balance sheet at a point in time. READ-ONLY.

MOMS/VAT report. READ-ONLY.

Invoiced sales by contact/product. READ-ONLY.

List ledger postings. READ-ONLY.

Recent activity log entries. READ-ONLY.

List webhooks. READ-ONLY.

Create a webhook. WRITE — requires confirm:true. Shape: { url, event, isActive? }

Remove a webhook. WRITE — requires confirm:true.

List currencies. READ-ONLY.

List countries. READ-ONLY.

List payment-terms modes. READ-ONLY.

List product units. READ-ONLY.

Upload a file (receipt or invoice PDF, or image) from a local path to Billy. WRITE — requires confirm:true. Billy only accepts PDF, JPG, JPEG, PNG, GIF — convert other formats first. Returns the file metadata including the id, which you then pass to billy_attach_file_to_bill or billy_attach_file_to_invoice. MIME type is auto-detected from the extension.

List files uploaded to Billy. READ-ONLY.

Fetch metadata for one file (incl. downloadUrl). READ-ONLY.

Attach an uploaded file (receipt PDF, etc.) to a bill. WRITE — requires confirm:true.

Attach an uploaded file to an invoice. WRITE — requires confirm:true.