Skip to main content
GET
List events

Authorizations

Authorization
string
header
required

Bearer authentication: send your API key, agent key, or OAuth access token as Authorization: Bearer <credential>.

Headers

X-Instance-ID
string | null

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Maximum string length: 1024

Query Parameters

customerPartyId
string

Defaults to your party. To act for another party, pass the ID of a party that has authorized you to act on its behalf.

Pattern: ^pty_[0-9a-f]{32}$
eventType
enum<string>

Filter by event type. Required when customerPartyId names another party.

Available options:
party.updated,
compliance_case.updated,
wallet.created,
external_account.connected,
agent_delegation_invitation.created,
agent_delegation_invitation.accepted,
agent_delegation_invitation.declined,
agent_delegation_invitation.canceled,
agent_delegation.revoked,
delegation.activated,
delegation.revoked,
invitation_link.created,
invitation_link.revoked,
invitation_link.agent_added,
invitation_link.agent_removed,
invitation_link.redeemed,
deposit.created,
deposit.completed,
deposit.failed,
deposit.returned,
deposit.canceled,
deposit.approval_denied,
withdrawal.created,
withdrawal.completed,
withdrawal.failed,
withdrawal.returned,
withdrawal.canceled,
withdrawal.approval_denied,
payment.created,
payment.completed,
payment.failed,
payment.returned,
payment.canceled,
payment.approval_denied,
ach.created,
ach.processing,
ach.settled,
ach.failed,
ach.returned,
realtime.created,
realtime.processing,
realtime.settled,
realtime.failed,
wire.created,
wire.processing,
wire.completed,
wire.rejected,
wire.failed,
check.created,
check.processing,
check.completed,
check.returned,
check.canceled,
check.expired,
check.rejected,
check.failed,
check.returned_to_sender,
external_party_account.validated,
approval.required,
approval.approved,
approval.denied,
approval.canceled,
payment_request.created,
payment_request.completed,
payment_request.canceled,
payment_request.declined,
payment_request.incoming,
paymentIntent.completed,
cardPayment.succeeded,
cardPayment.failed,
paymentIntent.canceled,
cardPayment.created,
voiceSession.completed,
refund.created,
refund.succeeded,
refund.failed,
chargeback.created,
chargeback.updated,
chargeback.closed,
enrollment.applied,
enrollment.activated,
enrollment.rejected,
enrollment.offboarded,
mandate.created,
mandate.updated,
mandate.revoked
createdAfter
string<date-time>

Only events created after this RFC 3339 timestamp (exclusive).

Maximum string length: 64
createdBefore
string<date-time>

Only events created before this RFC 3339 timestamp (exclusive).

Maximum string length: 64
cursor
string

Cursor from the previous page.

Maximum string length: 1024
limit
integer
default:50

Maximum results per page.

Required range: 1 <= x <= 100

Response

Successful Response

data
EventResource · object[]
required
meta
object
required