Invoices
List invoices
Every invoice owned by the current user, newest first.
GET
Filter to one of:
open, paid, void, uncollectible. Omit to return all
non-draft invoices. Note: send void over the wire — the TS type uses
void_ to avoid JS’s reserved word, the API uses bare void.Max 200.
Array of invoice objects.
Statuses
| Status | Means | What’s available |
|---|---|---|
open | Owed, not yet paid | hostedInvoiceUrl valid; Pay ↗ action |
paid | Settled via any Stripe path | receiptUrl valid; Receipt ↗ action |
void | Voided before payment | Historical record only |
uncollectible | 30+ days unpaid, written off | Historical record |
draft | Internal, transient | Not returned by default |
Reasons
| Reason | Trigger |
|---|---|
topup_failed | Auto-topup tried to charge the saved card and Stripe declined |
overage | Metered usage settled higher than the wallet balance |
manual | Ops-issued (refund correction, enterprise contract, wire xfer) |