Webhooks

List recent webhook delivery logs

GET
/api/v1/webhooks/config/logs

Scope: webhooks:manage

Recent delivery attempts with the HTTP status your endpoint returned — the first place to look when an event seems to have been missed.

Authorization

AuthorizationBearer <token>

Use Authorization: Bearer vrf_live_... or vrf_test_....

In: header

Query Parameters

page?integer

Zero-based page number. The first page is 0.

Range0 <= value
Default0
size?integer

Records per page. Large values are capped.

Range1 <= value <= 200
Default20
sortBy?string

Sort key. An unsupported key falls back to the endpoint's default order.

sortDirection?string

Sort direction.

Default"asc"

Value in

  • "asc"
  • "desc"

Response Body

application/json

curl -X GET "https://example.com/api/v1/webhooks/config/logs?page=0&size=20&sortBy=createdAt"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "eventType": "check.started",      "url": "http://example.com",      "status": "SUCCESS",      "httpStatus": 0,      "error": "string",      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "page": 0,  "size": 20,  "totalItems": 42,  "totalPages": 3,  "hasNext": true,  "hasPrevious": true}