Skip to main content
GET
/
v1
/
deliveries
List outbound delivery attempts
curl --request GET \
  --url https://api.webhook.co/v1/deliveries \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "eventId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "destinationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "subscriptionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "statusCode": 0,
      "attempt": 123,
      "error": "<string>",
      "nextRetryAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

​
Authorization
string
header
required

A whk_-prefixed API key (opaque; not a JWT).

Query Parameters

​
cursor
string

Opaque keyset cursor from a prior page's nextCursor.

​
limit
integer

Max items to return (1–200, default 50).

Required range: x <= 200
​
destinationId
string<uuid>

Filter by destination (empty = no filter).

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
subscriptionId
string<uuid>

Filter by subscription (empty = no filter).

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
​
status
enum<string>[]

Filter by delivery status (repeatable).

Available options:
queued,
forwarded,
pending,
delivered,
failed,
blocked,
dead,
cancelled

Response

Success.

​
items
object[]
required
​
nextCursor
string | null
required