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

# List Webhook Endpoints — GET /webhooks

> Page through your registered webhook endpoints. Secrets are never returned. Requires webhooks:read.

Returns a paginated list of your webhook endpoints, newest first. Signing secrets are never included. Requires the `webhooks:read` scope.

## Request

**`GET https://api.blockra.io/webhooks`**

### Query parameters

<ParamField query="page" default="1" type="integer">
  Page number (1-based).
</ParamField>

<ParamField query="limit" default="25" type="integer">
  Items per page (max 100).
</ParamField>

<ParamField query="sort" type="string">
  Sort column: `id`, `url`, `events`, `status`, or `created_at`.
</ParamField>

<ParamField query="order" default="desc" type="string">
  `asc` or `desc`.
</ParamField>

<ParamField query="filter_id" type="string">
  Exact endpoint ID.
</ParamField>

<ParamField query="filter_url" type="string">
  Substring match on the URL.
</ParamField>

<ParamField query="filter_status" type="string">
  Comma-separated: `active`, `inactive`.
</ParamField>

<ParamField query="start_date" type="string">
  ISO date string — return endpoints created on or after this date (e.g. `2026-01-01`).
</ParamField>

<ParamField query="end_date" type="string">
  ISO date string — return endpoints created before this date.
</ParamField>

## Response

<ResponseField name="items" type="array">
  The endpoints on this page (each: `id`, `url`, `events`, `is_active`, `created_at`).
</ResponseField>

<ResponseField name="total" type="integer">
  Total matching endpoints.
</ResponseField>

<ResponseField name="page" type="integer">
  Current page.
</ResponseField>

<ResponseField name="limit" type="integer">
  Page size.
</ResponseField>

<ResponseField name="total_pages" type="integer">
  Total number of pages.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.blockra.io/webhooks \
    -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "items": [
        {
          "id": "whk_3n4o5p6q7r8s9t0u",
          "url": "https://your-site.com/webhooks/blockra",
          "events": ["payment.completed", "payment.expired"],
          "is_active": true,
          "created_at": "2026-07-09T02:45:00.000Z"
        }
      ],
      "total": 1,
      "page": 1,
      "limit": 25,
      "total_pages": 1
    },
    "error": null
  }
  ```
</ResponseExample>