Skip to content
Bookrail

Search is only available in production builds. Try building and previewing the site to test it out locally.

List the deliveries of an endpoint

GET
/v1/webhooks/{id}/deliveries

Newest first, unlike every other list: a delivery log answers “what just happened”.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required

Identifier of the webhook.

string

Query Parameters

Section titled “Query Parameters ”
limit

How many objects to return, 1 to 100. Defaults to 20.

integer
>= 1 <= 100
Example
20
starting_after

Cursor: the id of the last object of the previous page.

string
/^whd_[0-9a-f]{32}$/
status
string
Allowed values: pending succeeded failed
event_id

Identifier of a event, prefixed with evt_.

string
/^evt_[0-9a-f]{32}$/
Example
evt_0198f0c2a1b47e2e9a1c0f4d5e6a7b8c

Header Parameters

Section titled “Header Parameters ”
Bookrail-Version

The dated API version to speak. Defaults to 2026-09-01; an unsupported value is a 400.

string
Example
2026-09-01
Bookrail-Actor

Which Bookrail tool the caller is, recorded as actor.via on every event the request writes. A closed list: an unknown value is a 400. Absent means the request declared no tool.

string
Allowed values: mcp cli sdk dashboard

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success.

object
object
required
string
Allowed values: list
data
required
Array<object>
object
id
required

Identifier of a webhook_delivery, prefixed with whd_.

string
/^whd_[0-9a-f]{32}$/
Example
whd_0198f0c2a1b47e2e9a1c0f4d5e6a7b8c
object
required
string
Allowed values: webhook_delivery
webhook_id
required

Identifier of a webhook, prefixed with wh_.

string
/^wh_[0-9a-f]{32}$/
Example
wh_0198f0c2a1b47e2e9a1c0f4d5e6a7b8c
event_id
required

Identifier of a event, prefixed with evt_.

string
/^evt_[0-9a-f]{32}$/
Example
evt_0198f0c2a1b47e2e9a1c0f4d5e6a7b8c
status
required
string
Allowed values: pending succeeded failed
attempt
required

Attempts started, not attempts left.

integer
response_status
required
integer | null
response_body
required
string | null
error
required
string | null
duration_ms
required
integer | null
scheduled_at
required

ISO 8601 instant in UTC.

string | null format: date-time
Example
2026-09-08T07:00:00Z
last_attempt_at
required

ISO 8601 instant in UTC.

string | null format: date-time
Example
2026-09-08T07:00:00Z
next_attempt_at
required

ISO 8601 instant in UTC.

string | null format: date-time
Example
2026-09-08T07:00:00Z
leased_until
required

Set only while an attempt is in flight; next_attempt_at stays the ladder.

string | null format: date-time
Example
2026-09-08T07:00:00Z
delivered_at
required

ISO 8601 instant in UTC.

string | null format: date-time
Example
2026-09-08T07:00:00Z
environment
required

The environment of the API key that created the object.

string
Allowed values: test live
created_at
required

ISO 8601 instant in UTC.

string | null format: date-time
Example
2026-09-08T07:00:00Z
updated_at
required

ISO 8601 instant in UTC.

string | null format: date-time
Example
2026-09-08T07:00:00Z
event_type

Type of the event this delivery carries. Joined in by the listing and by /test; absent from the answer of /retry.

string | null
has_more
required
boolean

Headers

Section titled “Headers ”
Bookrail-Request-Id
required

Identifier of this request. Quote it to support.

string
Bookrail-Version
required

The API version this response was produced with.

string

400

Section titled “400 ”

Error codes: parameter_invalid, parameter_missing, unsupported_api_version.

object
error
required
object
type
required
string
Allowed values: invalid_request authentication permission not_found conflict rate_limit policy_violation payment_required internal
code
required

Machine readable code. The set is per operation; each response below lists the ones it can produce.

string
message
required
string
param

The field or header the error is about, when there is one.

string
doc_url
required
string
request_id
required
string

Headers

Section titled “Headers ”
Bookrail-Request-Id
required

Identifier of this request. Quote it to support.

string
Bookrail-Version
required

The API version this response was produced with.

string

401

Section titled “401 ”

Error codes: invalid_api_key, invalid_authorization_header, missing_api_key, revoked_api_key.

object
error
required
object
type
required
string
Allowed values: invalid_request authentication permission not_found conflict rate_limit policy_violation payment_required internal
code
required

Machine readable code. The set is per operation; each response below lists the ones it can produce.

string
message
required
string
param

The field or header the error is about, when there is one.

string
doc_url
required
string
request_id
required
string

Headers

Section titled “Headers ”
Bookrail-Request-Id
required

Identifier of this request. Quote it to support.

string
Bookrail-Version
required

The API version this response was produced with.

string

404

Section titled “404 ”

Error codes: resource_missing.

object
error
required
object
type
required
string
Allowed values: invalid_request authentication permission not_found conflict rate_limit policy_violation payment_required internal
code
required

Machine readable code. The set is per operation; each response below lists the ones it can produce.

string
message
required
string
param

The field or header the error is about, when there is one.

string
doc_url
required
string
request_id
required
string

Headers

Section titled “Headers ”
Bookrail-Request-Id
required

Identifier of this request. Quote it to support.

string
Bookrail-Version
required

The API version this response was produced with.

string

500

Section titled “500 ”

Error codes: internal_error.

object
error
required
object
type
required
string
Allowed values: invalid_request authentication permission not_found conflict rate_limit policy_violation payment_required internal
code
required

Machine readable code. The set is per operation; each response below lists the ones it can produce.

string
message
required
string
param

The field or header the error is about, when there is one.

string
doc_url
required
string
request_id
required
string

Headers

Section titled “Headers ”
Bookrail-Request-Id
required

Identifier of this request. Quote it to support.

string
Bookrail-Version
required

The API version this response was produced with.

string