Webhook Deliveries

List webhook deliveries

List webhook delivery attempts newest first. Combine subscription, event, status, and timestamp filters to inspect failures, then use the returned opaque cursor for the next page.

get/webhook_deliveries

Request

  • Base URL: https://api.kirimdev.com/v1
  • URL: https://api.kirimdev.com/v1/webhook_deliveries
  • Auth: HTTP bearer

Query parameters

subscription_idstring

Return deliveries for one webhook subscription.

Example:wbs_01HXYZABCDEFGHJKMNPQRSTVWX
status'pending' | 'succeeded' | 'failed' | 'dead'

Filter by the latest delivery state.

Example:dead
event_typestring

Filter by exact webhook event type.

Example:message.received
created_afterstring date-time

Return deliveries created strictly after this ISO 8601 instant.

Example:2026-09-10T00:00:00.000Z
created_beforestring date-time

Return deliveries created strictly before this ISO 8601 instant.

Example:2026-09-11T00:00:00.000Z
limitstring

Number of items to return. Defaults to 25; minimum 1 and maximum 100.

Example:25
cursorstring

Opaque continuation token from the previous response's next_cursor. Pass it unchanged and keep all other filters the same.

Example:eyJpZCI6IjAxSFhZWkFCQ0RFRkdISktNTlBRUlNUVldYIiwidHMiOiIyMDI2LTA5LTEwVDA5OjAwOjAwLjAwMFoifQ

Response

Delivery list

has_moreboolean required

Whether another page is available.

next_cursorstring nullable required

Pass this value unchanged as cursor to fetch the next page. null marks the final page.

request_idstring required

Unique request identifier to include when contacting support.

Example response

{
  "data": [
    {
      "id": "wbd_01HXYZABCDEFGHJKMNPQRSTVWX",
      "error_code": "timeout"
    }
  ],
  "request_id": "req_01HXYZABCDEFGHJKMNPQRSTVWX"
}

Changes

No recorded changes to this operation across all 1 revision of this API.