Skip to content
Keptslot
Start free

List delivery attempts

GET
/v1/webhook-endpoints/{id}/deliveries
curl --request GET \
--url 'https://api.keptslot.com/v1/webhook-endpoints/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/deliveries?limit=50' \
--header 'Authorization: Bearer <token>'

This endpoint lists what was sent to one endpoint, newest first. Use it to see why a delivery failed.

next_cursor is ABSENT on the last page. It is not null. Test whether the key exists.

id
required
string format: uuid

The webhook endpoint id.

limit
integer
default: 50 <= 200
cursor
string
status
string

Limits the result to one delivery status.

One page of delivery attempts.

Media type application/json
object
data
required
Array<object>
object
id
required
string format: uuid
event_type
required
string
status
required
string
attempts
required
integer
response_status

The HTTP status your endpoint gave. Null before a reply.

integer | null
last_error
string | null
next_retry_at
string | null format: date-time
created_at
required
string format: date-time
completed_at
string | null format: date-time
payload
required

The body that was sent, or that will be sent.

object
next_cursor

Absent on the last page.

string
Example generated
{
"data": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"event_type": "example",
"status": "example",
"attempts": 1,
"response_status": 1,
"last_error": "example",
"next_retry_at": "2026-04-15T12:00:00Z",
"created_at": "2026-04-15T12:00:00Z",
"completed_at": "2026-04-15T12:00:00Z",
"payload": {}
}
],
"next_cursor": "example"
}

The key is missing, malformed or revoked.

Media type application/json
object
error
required
object
type
required

A stable machine-readable code. Match on this.

string
message
required

A sentence for a person. Do not match on this.

string
param

The field that caused the refusal, if one field did.

string
dimension

The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.

string
used

The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.

integer format: int64
limit

The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.

integer format: int64
Example generated
{
"error": {
"type": "example",
"message": "example",
"param": "example",
"dimension": "example",
"used": 1,
"limit": 1
}
}

There is no such resource in this workspace.

Media type application/json
object
error
required
object
type
required

A stable machine-readable code. Match on this.

string
message
required

A sentence for a person. Do not match on this.

string
param

The field that caused the refusal, if one field did.

string
dimension

The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.

string
used

The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.

integer format: int64
limit

The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.

integer format: int64
Example generated
{
"error": {
"type": "example",
"message": "example",
"param": "example",
"dimension": "example",
"used": 1,
"limit": 1
}
}

The request body or the query is not valid.

Media type application/json
object
error
required
object
type
required

A stable machine-readable code. Match on this.

string
message
required

A sentence for a person. Do not match on this.

string
param

The field that caused the refusal, if one field did.

string
dimension

The plan limit that refused the request. It is present only on a 402, and only for a secret key or an account key. See the errors guide.

string
used

The current count for that dimension. It is present only on a 402, and only for an account key. It is absent when the refusal has no count to report. Absent and zero are different answers.

integer format: int64
limit

The cap for that dimension. It is present only on a 402, and only for an account key. A cap of zero is a real value.

integer format: int64
Example generated
{
"error": {
"type": "example",
"message": "example",
"param": "example",
"dimension": "example",
"used": 1,
"limit": 1
}
}