Webhook Deliveries

List webhook deliveries

curl "https://api.subscriby.net/v1/webhook-deliveries?status=dead" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

The team's deliveries across every endpoint, newest first, 25 per page (per_page 1 to 100; limit is accepted as an alias).

get/v1/webhook-deliveries

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/webhook-deliveries
  • Auth: HTTP bearer

Query parameters

status'all' | 'pending' | 'delivered' | 'failed' | 'dead'

The status tab on the webhook delivery log. One case per delivery status plus "all", so the tab is an enum-backed Livewire property instead of a free string compared against a list in the query.

One of the log's tabs: all (the default), pending, delivered, failed or dead. A tab rather than a raw status, so an omitted value lists every row instead of quietly matching nothing. Anything else is refused.

pageinteger

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

per_pageinteger

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 15.

sort_bystring

The column to order by. Defaults to created_at; a column the endpoint does not offer falls back to the default rather than failing.

sort_direction'asc' | 'desc'

asc or desc. Defaults to desc.

limitinteger

Legacy alias of per_page, kept for clients that predate it. per_page wins when both are sent.

Response

The tenant's deliveries on that tab, newest first.

Example response

{
  "data": [
    {
      "id": "34f1d78e-05a2-4b69-8c3d-7e921ab06f45",
      "endpoint_id": "c62a08f4-1b7d-4e35-9860-a37f5d21e0b9",
      "event": "subscription.created",
      "event_id": "01HXZ3Q8M7Y2K4N6P9R1T3V5W7",
      "status": "failed",
      "attempts": 2,
      "response_status": 500,
      "response_excerpt": "upstream unavailable",
      "next_attempt_at": "2026-09-06T10:15:00+00:00",
      "created_at": "2026-09-06T10:05:00+00:00"
    }
  ]
}

Changes

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