Skip to main content
Every invoice carries two separate answers to “where does this stand?”: Read them together. An invoice that is Open and between_31_and_60_days is owed and a month or more past due. Once it’s Closed, its aging no longer matters.

​
Status

current_open_balance is the amount still owed, in cents. A partly paid invoice stays Open until its balance reaches zero. A payment on its way doesn’t change the status. A bank debit takes a few business days to settle, and until it does the invoice stays Open. When the payments in flight cover the whole balance, is_pending_close is true, so you can show “Payment processing” instead of chasing the customer.

​
Aging

Days are counted in your account’s time zone. An invoice with billing milestones is aged by its earliest issued milestone that still has a balance. If no milestone has been issued yet, it’s not_yet_due.

​
Check one invoice

This invoice was partly paid, $2,300.00 is still owed, and it’s up to 30 days past due. See Get invoice details for every field.

​
Filter your invoices

List invoices takes two filters for this:
  • status=unpaid returns Open invoices. status=paid returns everything else: Closed, Has Credit, and Voided.
  • invoice_state takes one or more comma-separated values: the aging values above (or overdue for every past-due bucket at once), closed, has_credit, voided, and quickpay or manual_billing.
For example, every past-due invoice for one customer:
Aging and status values combine with “or”: between_61_and_90_days,over_91_days returns invoices in either bucket. quickpay and manual_billing narrow the result, so overdue,quickpay returns past-due invoices for customers with QuickPay turned on.

​
Billing status

billing_status is quickpay when the customer has QuickPay (a saved card or bank account) turned on today, otherwise manual_billing. It describes the customer’s current setting, not how a particular invoice was paid. To see how an invoice was paid, look at its transactions.