Billing

List invoices

GEThttps://paysuitett.com/api/v1/invoices

Newest issue dates first. Invoice objects omit lines; money is in the invoice's currency (books holds the TTD amounts), with two decimal precision. paid excludes reversed payments; balanceDue subtracts posted credits and is zero for drafts/voids. URLs point to this installation's APP_URL host.

Access. Master key, or a personal key held by an owner/admin or accountant. The business must have the invoices service. Runs as the holder under their row-level security.

Query parameters

statusstring: Filter status.Allowed:draftpostedvoid
customerIdstring · uuid: Filter customer.
fromstring · date: First issue date, inclusive.
tostring · date: Last issue date, inclusive.
limitinteger: Default 50, maximum 200.

Response

200 with a JSON body, as in the example.

curl "https://paysuitett.com/api/v1/invoices" \
  -H "Authorization: Bearer $PAYSUITETT_API_KEY"

Success

{
  "invoices": [
    {
      "id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
      "number": "INV-DRAFT",
      "numberEnteredManually": false,
      "status": "draft",
      "currency": "TTD",
      "exchangeRate": null,
      "customer": {
        "id": "4e5f6a7b-8c9d-4e0f-9a1b-2c3d4e5f6a7b",
        "name": "Customer",
        "email": "customer@example.com"
      },
      "issueDate": "2026-10-15",
      "dueDate": "2026-11-14",
      "servicePeriod": {
        "start": "2026-10-01",
        "end": "2026-10-14",
        "text": "1–14 Oct 2026"
      },
      "qtyLabel": "hours",
      "notes": null,
      "subtotal": 300,
      "vatTotal": 37.5,
      "total": 337.5,
      "books": {
        "currency": "TTD",
        "subtotal": 300,
        "vatTotal": 37.5,
        "total": 337.5,
        "conversionFeePercent": null,
        "conversionFeeTtd": null,
        "totalTyped": false
      },
      "paid": 0,
      "balanceDue": 0,
      "urls": {
        "app": "https://paysuitett.com/admin/sales/invoices/6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
        "pdf": "https://paysuitett.com/admin/sales/invoices/6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d/pdf",
        "timeSchedule": "https://paysuitett.com/admin/sales/invoices/6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d/time-schedule",
        "workReport": "https://paysuitett.com/admin/sales/invoices/6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d/work-report"
      }
    }
  ]
}