Invoice Lifecycle

Invoices progress through a defined set of statuses. Understanding this lifecycle is important when building integrations.

Status flow

draft → finalized → sent → paid
                        ↓
                     overdue  (set automatically when past due date)

Any status → void

Status	Description
`draft`	Editable. Not yet issued. Line items can be added, changed, or removed.
`finalized`	Locked for editing. Amounts are fixed. Ready to send to the client.
`sent`	Issued to the client. Payment reminder schedule begins.
`paid`	Payment has been recorded (manually or via Stripe).
`overdue`	Was sent but the due date has passed without payment. Set automatically.
`void`	Cancelled. No further state changes are permitted.

Only draft invoices can be updated (PATCH /invoices/{id}) or deleted. Attempting to edit a non-draft invoice returns 422 Unprocessable.