List Org Events

GET

/events

• Production
• QA

List the organisation’s events, newest first, with cursor pagination.

Covers every event the EDA pipeline stores for the org plus website tracking rows. Filters combine with AND. Pages are stable under concurrent writes: the cursor encodes the last (timestamp, uid) seen.

Authorizations

• BearerAuth

Parameters

Query Parameters

type

Any of:

Array<string>

Array<string>

null

null

Filter by event type (repeatable), e.g. sequencer, inbox, voiceai.

name

Any of:

Array<string>

Array<string>

null

null

Filter by event name (repeatable), e.g. sequence_email_replied.

source

Any of:

string

string

<= 200 characters

null

null

Filter by producing service.

contact_id

Any of:

string

string

<= 200 characters

null

null

Only events whose message.contact_id matches.

sequence_id

Any of:

string

string

<= 200 characters

null

null

Only events whose message.sequence_id matches.

campaign_id

Any of:

string

string

<= 200 characters

null

null

Only events whose message.campaign_id matches.

since

Any of:

string

string format: date-time

null

null

Window start (ISO 8601). Defaults to 7 days before until.

until

Any of:

string

string format: date-time

null

null

Window end, exclusive (ISO 8601). Defaults to now.

cursor

Any of:

string

string

<= 512 characters

null

null

next_cursor from the previous page.

limit

Page size.

integer

default: 50 >= 1 <= 200

Page size.

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Responses

200

Successful Response

object

data

required

A page of events, newest first.

object

events

Array<object>

One event from the org’s event store.

object

actor_email

Any of:

string

string

null

null

campaign_id

Any of:

string

string

null

null

contact_id

Any of:

string

string

null

null

id

Any of:

string

string

null

null

message

The event payload exactly as produced.

object

key

additional properties

any

name

Any of:

string

string

null

null

occurred_at

Any of:

string

string

null

null

sequence_id

Any of:

string

string

null

null

source

Any of:

string

string

null

null

type

Any of:

string

string

null

null

url

Any of:

string

string

null

null

has_more

Whether another page exists within the requested window.

boolean

next_cursor

Any of:

string

string

null

null

since

required

Lower bound of the window that was searched (ISO 8601, UTC).

string

until

required

Upper bound of the window that was searched (ISO 8601, UTC).

string

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string