Skip to main content
GET
Read the durable event ledger (catch-up)

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Query Parameters

since
string

Opaque keyset cursor (from a prior pagination.nextCursor) to read forward from.

limit
integer
default:25
Required range: 1 <= x <= 100
inboxId
string

Filter to one inbox partition.

type
string

Filter to one event type, e.g. email.bounced.

idempotencyKey
string

Return every event carrying this loop-wide idempotency key.

Response

Success

object
enum<string>
required

Always "list" — the unified list envelope discriminator.

Available options:
list
data
object[]
required

The ledger events for this page, each with seq/partitionKey join keys. (This is the array named data, not events.)

pagination
object
required
gaps
object[]
required

Per-partition seq gaps detected within this page's window. An empty array means no gap was detected in the returned window — detection is window-local (only the seq range present on this page), not whole-history.