List Webhook Endpoints — GET /webhooks

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

page

integer

default:"1"

Page number (1-based).

limit

integer

default:"25"

Items per page (max 100).

sort

string

Sort column: id, url, events, status, or created_at.

order

string

default:"desc"

asc or desc.

filter_id

string

Exact endpoint ID.

filter_url

string

Substring match on the URL.

filter_status

string

Comma-separated: active, inactive.

start_date

string

ISO date string — return endpoints created on or after this date (e.g. 2026-01-01).

end_date

string

ISO date string — return endpoints created before this date.

Response

items

array

The endpoints on this page (each: id, url, events, is_active, created_at).

total

integer

Total matching endpoints.

page

integer

Current page.

limit

integer

Page size.

total_pages

integer

Total number of pages.

curl https://api.blockra.io/webhooks \
  -H "X-API-Key: bk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "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
}

​Request

​Query parameters

​Response

Request

Query parameters

Response