Events endpoint v2
Query and replay events that have flowed through a pipeline.
List events
GET /v2/pipelines/{pipeline_id}/events — cursor-paginated, filterable by type and occurred_at range.
| Name | Type | Required | Description |
|---|---|---|---|
type | string | No | Filter to a single event type, e.g. order.created. |
since | string | No | ISO-8601 timestamp lower bound on occurred_at. |
cursor | string | No | Opaque pagination cursor from a previous response's next_cursor. |
event.json
json
{
"id": "evt_8f2c1a90",
"type": "order.created",
"occurred_at": "2026-08-18T09:12:44Z",
"payload": { "order_id": "ord_4471" }
}
Replay a dead-lettered event
POST /v2/events/{id}/replay — re-runs an event that exhausted its retries from where it was dead-lettered. See the Handling errors & retries guide for when to use this versus reprocessing an entire time range.
Platform events
Lifecycle notifications like pipeline.started and connector.error are not returned by this endpoint — subscribe to them through the Webhooks endpoint instead.
On this page