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

# List webhooks

> Returns all webhook endpoints for the account. Up to 10 webhook endpoints per account.

<ParamField header="x-api-key" type="string" required>
  BOH API key with `admin:webhooks` scope.
</ParamField>

<ResponseField name="endpoints" type="object[]">
  Array of webhook endpoint objects. Each endpoint: `id`, `url`, `events`, `is_active`, `disabled_reason`, `consecutive_failures`, `created_at`, `updated_at`.
</ResponseField>

<RequestExample>
  ```http theme={null}
  GET /api/v1/public/admin/webhooks
  x-api-key: boh_live_xxxxxxxx
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "endpoints": [
      {
        "id": "wep_01j5k...",
        "url": "https://yourapp.com/webhooks/boh",
        "events": ["inventory_transaction.completed", "purchase_order.status_changed"],
        "is_active": true,
        "disabled_reason": null,
        "consecutive_failures": 0,
        "created_at": "2026-07-01T09:00:00.000Z",
        "updated_at": "2026-07-01T09:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>