> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fortary.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List webhook events

<Info>
  **Pre-release** — contact your Fortary account team for access.
</Info>

<Warning>
  **Illustrative reference.** These examples show the shape of the API and are provided for early evaluation while it is still being finalized. Field names and response details may change before the API is released. A complete reference, generated directly from the live API, will replace these examples once it is available.
</Warning>

Lists the event log: every event from the last **31 days**, recorded whether or not a webhook matched it. Requires the `webhook:read` scope.

## Request

```bash theme={null}
curl "https://customer-api.fortary.io/v1/webhook-events?kind=transaction.confirmed" \
  -H "Authorization: Bearer fort_..."
```

Query parameters (all optional):

* **`kind`** — exact [event kind](/api/reference/webhooks/event-types) filter.
* **`vaultId`** — only vault-scoped events touching this vault.
* **`occurredAfter`** / **`occurredBefore`** — inclusive bounds on the occurrence time.

## Response

```json theme={null}
{
  "data": [
    {
      "id": "evt_01hz8x2k9qv7m3ntf5rw6ye8ka",
      "entityId": "entity_7c1e4a0c2f",
      "vaultIds": ["vault_3f8a2c1d9b"],
      "kind": "transaction.confirmed",
      "schemaVersion": 1,
      "payload": { /* the delivered envelope — see Event types */ },
      "occurredAt": "2026-06-10T14:23:05Z",
      "dispatchedAt": "2026-06-10T14:23:05Z",
      "createdAt": "2026-06-10T14:23:05Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "nextCursor": null
  }
}
```

* **`payload`** — the exact [event envelope](/api/reference/webhooks/event-types#the-event-envelope) delivered to matching webhooks.
* **`vaultIds`** — the vaults involved, or `null` for non-vault-scoped events.
* **`occurredAt`** — when the event occurred (the envelope's `date`).
* **`dispatchedAt`** — when deliveries were fanned out; `null` while dispatch is pending.

To page through a longer list, pass `nextCursor` back — see [Pagination](/api/concepts/pagination).

Errors follow the standard [error envelope](/api/concepts/errors).