Webhook deliveries
Inspect delivery attempts and failures for debugging and monitoring.
The webhook delivery model
Deliveries are stored with a delivery id, an event name, and retry metadata. Payload bodies are not exposed by this endpoint.
Properties
-
- Name
id- Type
- integer
- Description
- Unique identifier for this delivery record.
-
- Name
delivery_id- Type
- string
- Description
- Stable identifier for webhook delivery attempts.
-
- Name
event- Type
- string
- Description
- Event name for the delivery.
-
- Name
status- Type
- string
- Description
- Delivery status (
pending,sent,failed).
GET/v1/webhook-deliveries/
List webhook deliveries
List webhook delivery records. Filter by endpoint_id, status, and pagination params.
Required scope
webhooks:manage
Request
GET
/v1/webhook-deliveries/curl -G https://api.twentybaan.com/v1/webhook-deliveries/ \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d endpoint_id=123 \
-d limit=10Response
{
"ok": true,
"items": [
{
"id": 456,
"endpoint_id": 123,
"delivery_id": "whd_01J0Y7...",
"event": "listing.published",
"attempts": 0,
"next_attempt_at": 1768212000,
"status": "pending",
"last_http_status": null,
"last_error": null,
"created_at": 1768212000,
"created_at_iso": "2026-01-12T08:00:00Z",
"sent_at": null,
"sent_at_iso": null
}
],
"next_before_id": null
}GET/v1/webhook-deliveries/?id=:id
Retrieve a webhook delivery
Fetch a single delivery record by id.
Required scope
webhooks:manage
Request
GET
/v1/webhook-deliveries/?id=456curl -G https://api.twentybaan.com/v1/webhook-deliveries/ \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d id=456Response
{
"ok": true,
"delivery": {
"id": 456,
"endpoint_id": 123,
"delivery_id": "whd_01J0Y7...",
"event": "listing.published",
"attempts": 0,
"next_attempt_at": 1768212000,
"status": "pending",
"last_http_status": null,
"last_error": null,
"created_at": 1768212000,
"created_at_iso": "2026-01-12T08:00:00Z",
"sent_at": null,
"sent_at_iso": null
}
}