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-Agent-ID
string | null

Deprecated: agent identity comes from the credential. Sending this header with a party API key or user credential returns 403 agent_credential_required.

Maximum string length: 36
Pattern: ^agt_[0-9a-f]{32}$
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

partyId
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 partyId 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,
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,
mandate.created,
mandate.revoked
createdAfter
string<date-time>

Return events created after this timestamp.

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

Return events created before this timestamp.

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