Contents

API reference

Events

API reference descriptions are provided in English to preserve the exact published contract.

List retained customer events

GET /v1/accounts/{AC}/events

List the events retained for your account, newest first, whether or not a webhook received them. Required scope: `events:read`.

Parameters

Parameters
NameTypeRequiredDescription
limitquery · integer (1–100)
cursorquery · string (max 2048 chars)
sortquery · "createdAt" | "-createdAt"
typequery · string (max 128 chars)
createdAfterquery · string (date-time)
resourcequery · string (max 128 chars)
endpointSidquery · string (WH… SID)
deliveryStatequery · "PENDING" | "IN_FLIGHT" | "SUCCEEDED" | "FAILED" | "DROPPED"
ACpath · string (AC… SID)yesAccount SID

Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors.

Fetch a retained customer event

GET /v1/accounts/{AC}/events/{EV}

Fetch one event exactly as it was delivered to your webhooks. Required scope: `events:read`.

Parameters

Parameters
NameTypeRequiredDescription
ACpath · string (AC… SID)yes
EVpath · string (EV… SID)yes

Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors.