API reference

Invoices & payments

Invoices and quotes with line items, plus manual payment recording. Creating fires invoice.created or quote.created; full payment fires invoice.paid.

https://api.mytabulon.com/v1

GET/invoicesinvoices.read

List invoices. Filters: status, document_type (invoice or quote), client_id.

POST/invoicesinvoices.write

Create an invoice or quote. Use an Idempotency-Key header for safe retries.

request

{
  "client_id": "9c2f...",
  "due_date": "2026-07-01",
  "tax_rate": 7.5,
  "items": [
    {
      "description": "Retainer",
      "quantity": 1,
      "unit_price": 1200
    }
  ]
}

response

{
  "object": "invoice",
  "id": "...",
  "invoice_number": "INV-2026-0042",
  "status": "draft",
  "subtotal": 1200,
  "total": 1290,
  "balance_due": 1290,
  "items": [...]
}

GET/invoices/{id}invoices.read

Retrieve an invoice with its line items and payment history.

POST/invoices/{id}/paymentspayments.write

Record a manual payment. Balance recalculates and payment.recorded fires.

request

{
  "amount": 600,
  "payment_method": "bank_transfer",
  "reference": "TRX-991",
  "payer_email": "ops@globex.com"
}