List a webhook's deliveries

Lists the webhook's deliveries, newest first.

Errors

Status	`type`	`code`	When
400	`invalid_request`	`invalid_cursor`	For a cursor this list did not return.
404	`not_found`	`webhook_not_found`	When the project has no such webhook.

It can also fail with the errors every operation shares, such as unauthenticated; see Errors.

More in Webhooks

Something wrong or missing on this page? Tell us by email or on Discord.

PreviousSend a test event NextRetrieve a webhook delivery

On this page

Authorization Path parameters Query parameters Examples Response body Errors More in Webhooks

Authorization

AuthorizationBearer <token>

A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.

In: header

Path parameters

projectId*string

The project's id, proj_.... A secret key works only in the project it belongs to.

webhookId*string

The webhook's id, wh_ep_....

Query parameters

cursor?string

Where the page starts: the pageInfo.endCursor of the previous page. Omit it for the first page.

limit?integer

How many items to return, from 1 to 100. Defaults to 50.

Range1 <= value <= 100

Examples

curl -X GET "https://api.voidhash.com/api/v1/projects/proj_tz4a98xxat96iws9zmbrgj3a/webhooks/wh_ep_q5w8e2r7t1y4u9i3o6p0a2s5/deliveries" \  -H "Authorization: Bearer vh_sk_..."

{  "data": [    {      "id": "wh_del_c9v2b5n8m1q4w7e0r3t6z3x6",      "projectId": "proj_tz4a98xxat96iws9zmbrgj3a",      "webhookId": "wh_ep_q5w8e2r7t1y4u9i3o6p0a2s5",      "eventType": "test.ping",      "payload": {        "message": "This is a test webhook delivery",        "timestamp": "2026-03-01T10:02:00.000Z"      },      "status": "succeeded",      "attemptCount": 1,      "maxAttempts": 5,      "eventOccurredAt": "2026-03-01T10:02:00.000Z",      "nextAttemptAt": null,      "completedAt": "2026-03-01T10:02:01.000Z",      "createdAt": "2026-03-01T10:02:00.000Z"    }  ],  "pageInfo": {    "endCursor": null,    "hasNextPage": false  }}

{  "error": {    "type": "invalid_request",    "code": "invalid_cursor",    "message": "This cursor does not continue the list. Start again without a cursor.",    "param": "cursor"  }}

{  "error": {    "type": "unauthenticated",    "code": "invalid_api_key",    "message": "This secret key is not valid."  }}

{  "error": {    "type": "permission_denied",    "code": "permission_denied",    "message": "Insufficient permissions."  }}

{  "error": {    "type": "not_found",    "code": "webhook_not_found",    "message": "This project has no webhook wh_ep_q5w8e2r7t1y4u9i3o6p0a2s5.",    "param": "webhookId"  }}

{  "error": {    "type": "internal",    "code": "internal_error",    "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing."  }}

List a webhook's deliveries

Errors

More in Webhooks

List a webhook's deliveries

Errors

More in Webhooks

Authorization

Path parameters

Query parameters

Examples

Response body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

List a webhook's deliveries

List a webhook's deliveries

webhook_not_found

project_not_found

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`