Skip to content

List a webhook’s deliveries (cursor-paginated)

GET
/webhooks/{id}/deliveries
curl --request GET \
--url https://api.vendorica.com/v1/webhooks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/deliveries \
--header 'Authorization: Bearer <token>'

Cursor-paginated read of the delivery log for one webhook, newest first. Pass ?cursor=<opaque>&limit=<n> to advance; the response carries cursor.nextCursor (null on the last page) plus cursor.hasMore. Each delivery is pending, retrying (a failed attempt is waiting for nextAttemptAt), succeeded or failed (terminal), and embeds every attempt made for it in attempts, oldest first.

id
required
string format: uuid
cursor
string
limit
integer
>= 1 <= 100

Success

Media typeapplication/json
object
success
required
boolean
data
required
Array<object>
object
id
required
string format: uuid
webhookId
required
string format: uuid
trigger
required
string
apiVersion
required
string
status
required
string
Allowed values: pending retrying succeeded failed
payload
required
object
key
additional properties
responseStatus
required
integer | null
errorMessage
required
string | null
durationMs
required
integer | null
sentAt
required
string | null format: date-time
attemptCount
required
integer
nextAttemptAt
required
string | null format: date-time
lastFailureClass
required
string | null
Allowed values: timeout network http_408 http_429 http_5xx http_4xx http_410 http_unsupported redirect blocked webhook_inactive
attempts
required
Array<object>
object
attemptNumber
required
integer
startedAt
required
string format: date-time
finishedAt
required
string | null format: date-time
responseStatus
required
integer | null
failureClass
required
string | null
Allowed values: timeout network http_408 http_429 http_5xx http_4xx http_410 http_unsupported redirect blocked
errorMessage
required
string | null
durationMs
required
integer | null
isReplay
required
boolean
replayOfDeliveryId
required
string | null format: uuid
createdAt
required
string | null format: date-time
timestamp
required
string format: date-time
requestId
string
message
string
cursor
required
object
nextCursor
required
string | null
hasMore
required
boolean
limit
required
integer
Example
{
"success": true,
"data": [
{
"id": "dbbb7e62-4827-4120-89e0-9a19b9929ba7",
"webhookId": "b9b6a755-b189-4df5-8158-1a42b3b15c32",
"trigger": "string",
"apiVersion": "string",
"status": "pending",
"payload": {},
"responseStatus": 1,
"errorMessage": "string",
"durationMs": 1,
"sentAt": "2026-08-19T09:41:12.004Z",
"attemptCount": 1,
"nextAttemptAt": "2026-08-19T09:41:12.004Z",
"lastFailureClass": "timeout",
"attempts": [
{
"attemptNumber": 1,
"startedAt": "2026-08-19T09:41:12.004Z",
"finishedAt": "2026-08-19T09:41:12.004Z",
"responseStatus": 1,
"failureClass": "timeout",
"errorMessage": "string",
"durationMs": 1
}
],
"isReplay": true,
"replayOfDeliveryId": "4f20ca24-b69e-49d2-8c15-0403cc155705",
"createdAt": "2026-08-19T09:41:12.004Z"
}
],
"timestamp": "2026-08-19T09:41:12.004Z",
"requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H",
"message": "string",
"cursor": {
"nextCursor": "string",
"hasMore": true,
"limit": 1
}
}

Validation error

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
"success": false,
"error": "Bad request",
"code": "BAD_REQUEST",
"timestamp": "2026-08-19T09:41:12.004Z",
"requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

Unauthorized

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
"success": false,
"error": "Unauthorized",
"code": "UNAUTHORIZED",
"timestamp": "2026-08-19T09:41:12.004Z",
"requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

Forbidden — missing scope

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
"success": false,
"error": "Forbidden",
"code": "FORBIDDEN",
"timestamp": "2026-08-19T09:41:12.004Z",
"requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

Not found

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
"success": false,
"error": "Resource not found",
"code": "NOT_FOUND",
"timestamp": "2026-08-19T09:41:12.004Z",
"requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

Rate limit exceeded

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
"success": false,
"error": "Too many requests",
"code": "TOO_MANY_REQUESTS",
"timestamp": "2026-08-19T09:41:12.004Z",
"requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}