Skip to content

List a webhook's deliveries

GET
/v1/webhooks/{webhook_id}/deliveries
curl --request GET \
--url http://api.disclosebot.localdev:3000/v1/webhooks/example/deliveries \
--header 'Authorization: Bearer <token>'
webhook_id
required
string
q[status_eq]
string
page[number]
integer
page[size]
integer

Filtered by status

Media type application/vnd.api+json
object
data
required
Array<object>
object
id
required

Also the webhook-id header of every attempt, and the consumer’s idempotency key.

string format: uuid
type
required
string
Allowed values: webhook_delivery
attributes
required
object
status
required
string
Allowed values: pending delivered failed
trigger_event_type
required
string
request_id

Present when a channel asked for the delivery, null for an event subscription.

string format: uuid
nullable
attempts
required
integer
attempt_log
required

One entry per attempt, oldest first, with what the endpoint said.

Array<object>
object
n
integer
at
string format: date-time
rate_limited
boolean
response
object
code
integer
nullable
body_excerpt
string
nullable
error
string
nullable
payload
required

What was sent, built when the delivery was created and never rebuilt.

object
delivered_at
string format: date-time
nullable
created_at
required
string format: date-time
updated_at
required
string format: date-time
relationships
object
webhook
object
data
object
id
required
string format: uuid
type
required
string
Allowed values: webhook
Example
{
"data": [
{
"type": "webhook_delivery",
"attributes": {
"status": "pending"
},
"relationships": {
"webhook": {
"data": {
"type": "webhook"
}
}
}
}
]
}

Unauthorized

A webhook of another organisation