invoice.overdue

{ "event": "invoice.overdue", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "invoiceId": "inv_n4o5p6", "invoiceNumber": "INV-0043", "invoiceStatus": "outstanding", "periodStart": "2026-04-25T00:00:00.000Z", "periodEnd": "2026-05-25T00:00:00.000Z", "issueDate": "2026-04-25T00:00:00.000Z", "dueDate": "2026-04-25T00:00:00.000Z", "currency": "usd", "subtotal": 9900, "total": 9900, "customerId": "user_123", "subscriptionId": "sub_1a2b3c4d" } }

When this fires

A daily scan finds outstanding invoices whose dueDate is in the past and emits this event once per invoice. The idempotency key is derived from the invoice, so re-running the scan never sends a duplicate.

The invoice keeps its "outstanding" status — overdue is a fact about the due date, not a new status. If the invoice is later paid or voided, payment.received or invoice.voided reflects the outcome.

Use it to start your own dunning flow: email the customer, show an in-app banner, or flag the account for follow-up.

Body

application/json

string

required

event

string

required

Allowed value: "invoice.overdue"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

invoice.overdue

When this fires

Body

Response

​When this fires

Body

Response

When this fires