Skip to main content

Cross-invoice lifecycle delta poll

GET 
/v1/invoice-lifecycle-messages

Returns lifecycle messages recorded since a given timestamp, scoped to one or more ext_reference_N filters.

When to use this: pulling lifecycle events for many invoices at once (typical case: a connector polling every N minutes for "what's changed"). For a single known invoice, use GET /invoices/{token}/lifecycle-messages.

Watermark: messages are ordered and filtered by recorded_at (when Nuntiq learned of the event), NOT occurred_at. This guarantees back-dated events that arrive after a previous poll are still picked up by the next poll.

ext_reference filtering: case-insensitive equality (LOWER(col) = LOWER($)). Wildcards are NOT interpreted — % and _ are matched literally.

Pagination: cursor-based. The response includes next_cursor (or null on the final page); pass it back as the cursor query param to fetch the next page. The cursor is stable across concurrent inserts so you will not skip rows that arrive mid-poll.

Required: since, tz, and at least one non-empty ext_reference_N.

Request​

Responses​

Lifecycle messages page