> ## 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 webhooks

<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 webhooks across the credential's accessible entities. Requires the `webhook:read` scope.

## Request

```bash theme={null}
curl https://customer-api.fortary.io/v1/webhooks \
  -H "Authorization: Bearer fort_..."
```

## Response

```json theme={null}
{
  "data": [
    {
      "id": "whs_9b2f4e1a7c",
      "entityIds": ["entity_7c1e4a0c2f"],
      "url": "https://example.com/fortary/webhooks",
      "notificationEmail": "ops@example.com",
      "eventKinds": ["transaction.confirmed", "transaction.failed"],
      "vaultIds": null,
      "status": "ENABLED",
      "disabledReason": null,
      "consecutiveExhaustedCount": 0,
      "lastDeliveredAt": "2026-06-10T14:23:07Z",
      "description": "Treasury reconciliation",
      "createdAt": "2026-05-02T09:12:44Z",
      "updatedAt": "2026-06-01T16:40:03Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "nextCursor": null
  }
}
```

Each item is a webhook — fields are described in [Get webhook](/api/reference/webhooks/get-webhook).

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

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