Webhook recovery

GET /v2/webhooks/events

Changed on

Request

Query parameters

event_namestring

Exact event name or one trailing .* prefix wildcard, such as deposit.*.

status'FAILED' | 'PROCESSING' | 'DELIVERED' | 'NOT_SUBSCRIBED'

Aggregate delivery state across the event's subscription targets.

Example:FAILED

PROCESSING while fan-out or any target is unfinished; FAILED after all finish if any failed; DELIVERED when all targets returned 2xx; NOT_SUBSCRIBED when fan-out found no target.

account_idstring

Main or sub-account ID.

created_afterstring date-time

Inclusive creation lower bound intersected with the server 30-day window.

created_beforestring date-time

Exclusive creation upper bound intersected with the server request time.

sizeinteger

Number of events per page (1-100; default 10).

cursorstring

Opaque continuation. Use the previous page's next_cursor; the example only illustrates its format.

Response

has_moreboolean required

A continuing page may be empty because of filters or excluded parents.

next_cursorstring nullable

Version-2 position of the last examined creation-time/ID pair; each next page uses a fresh server window.

Example response

{
  "events": [
    {
      "id": "123456",
      "name": "deposit.completed",
      "account_id": "BZ-ABCD-1234",
      "created_at": "2026-09-28T12:00:00Z",
      "payload": {
        "event_name": "deposit.completed",
        "resource": {
          "type": "deposits",
          "id": "550e8400-e29b-41d4-a716-446655440000"
        },
        "data": {
          "amount": "1.00"
        }
      },
      "status": "DELIVERED",
      "subscriptions": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "status": "DELIVERED",
          "active": true
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "MjoxNzkwNTk2ODAwMDAwOjEyMzQ1Ng"
}

Changes