Skip to main content
GET
List webhook events

Authorizations

Authorization
string
header
required

Partner server key (tpk_...), issued by Totalis to a registered partner. It calls only POST /v1/partner/wallet-admissions, GET /v1/partner/report, GET /v1/partner/fills, GET /v1/partner/webhook-events and GET /v1/partner/accounts/{wallet}/account-value, from the partner's server with no Origin. It reads the value of an account the partner admitted but cannot act for an account. Never ship it to a browser: pages use the publishable browser key (X-Totalis-Partner: tpb_...), which labels traffic but authorizes nothing.

Query Parameters

since
string<date-time>

List only events queued at or after this RFC 3339 time.

cursor
string

Omit for the oldest events kept; then send a previous response's next_cursor unchanged. Opaque list cursor. Send a previous response's next_cursor back unchanged; never build or parse one.

Required string length: 1 - 2048
limit
integer
default:50

Maximum items per page, 1 to 200, default 50. A page may hold fewer, even none, while has_more is true. Maximum items in one page. A page may hold fewer, even none, while has_more is true.

Required range: 1 <= x <= 200

Response

A page of your webhook events. No caching.

events
object[]
required

Events in the order Totalis queued them, oldest first.

Maximum array length: 200
next_cursor
string | null
required

Send it as cursor for the events after this page. It follows the last event even when has_more is false, so keep it and read again later for new events. Null only when no event has been returned yet.

Required string length: 1 - 2048
has_more
boolean
required

Whether more events follow.