List webhook delivery history

GET/v1/webhook_deliveries

Lists webhook deliveries and their retained applied attempts, newest delivery first. Without an exact delivery_id, event_id, or trace_id lookup, the time window defaults to the latest 24 hours and cannot exceed 30 days. Exact identifiers may reach older retained evidence.

Successful delivery detail becomes eligible for sweeping after 30 days; failed evidence may remain longer. The response therefore publishes an inclusive successful-history incompleteness horizon and the instant when attempt-history collection began. Neither is a blanket retention promise.

spent_attempt_count can exceed observed_attempt_count when an attempt ends without a retained verdict. Such a gap is reported, never filled with an invented attempt result. Payloads, bodies, headers, credentials, signatures, diagnostic errors and destination URL paths are never returned.

Query ParametersExpand Collapse

cursor: optional string

delivery_id: optional string

endpoint_id: optional string

event_id: optional string

event_kind: optional string

from: optional string

formatdate-time

limit: optional number

formatint32

maximum100

minimum1

outcome: optional string

to: optional string

formatdate-time

trace_id: optional string

ReturnsExpand Collapse

DeliveryPage object { attempt_history_coverage_started_at, data, has_more, 3 more }

A bounded page of webhook deliveries. Parent deliveries are never split across pages.

attempt_history_coverage_started_at: string

Inclusive instant when attempt-history collection began. Earlier deliveries cannot claim complete attempt history.

formatdate-time

data: array of Delivery { id, attempt_history_complete, attempts, 10 more }

id: string

attempt_history_complete: boolean

True only when every spent attempt has a retained applied verdict and collection covered this delivery from creation.

attempts: array of DeliveryAttempt { attempt, attempt_completed_at, attempt_started_at, 9 more }

attempt: number

The spent attempt number. Gaps mean a lease expired without an applied verdict.

formatint32

attempt_completed_at: string

formatdate-time

attempt_started_at: string

formatdate-time

destination: string

Scheme, host and effective port only. Path, query, fragment and credentials are never returned.

http_status: number

Response status, or null when no response was received.

formatint32

phase: string

pre_dial when no request began, or wire after the HTTP round trip began.

reason_code: string

A bounded machine reason. Treat unknown values as unknown.

verdict: string

delivered, retryable, or permanent. Treat unknown values as an unavailable verdict.

wire_completed_at: string

formatdate-time

wire_duration_ms: number

formatint64

wire_started_at: string

formatdate-time

trace_id: optional string

W3C trace id when one was recorded. Correlation only; never authorization.

created_at: string

formatdate-time

endpoint_id: string

event_id: string

event_kind: string

observed_attempt_count: number

Applied attempt verdicts retained below.

formatint32

seq_from: number

formatint64

seq_to: number

formatint64

spent_attempt_count: number

Attempts spent by the delivery machine, including leases that expired without an applied verdict.

formatint32

state: string

pending, delivering, delivered, permanent_refusal, or retry_exhausted.

chat_id: optional string

has_more: boolean

older_successful_history_may_have_been_swept: boolean

True when successful delivery detail may have been swept from this account partition.

successful_history_incomplete_through: string

Inclusive creation-time horizon through which successful delivery detail may be incomplete.

formatdate-time

next_cursor: optional string

List webhook delivery history

curl https://whatsapp.messages.api.linqapp.com/v1/webhook_deliveries \
    -H "Authorization: Bearer $LINQ_WHATSAPP_API_KEY"

{
  "attempt_history_coverage_started_at": "2019-12-27T18:11:19.117Z",
  "data": [
    {
      "id": "id",
      "attempt_history_complete": true,
      "attempts": [
        {
          "attempt": 0,
          "attempt_completed_at": "2019-12-27T18:11:19.117Z",
          "attempt_started_at": "2019-12-27T18:11:19.117Z",
          "destination": "destination",
          "http_status": 0,
          "phase": "phase",
          "reason_code": "reason_code",
          "verdict": "verdict",
          "wire_completed_at": "2019-12-27T18:11:19.117Z",
          "wire_duration_ms": 0,
          "wire_started_at": "2019-12-27T18:11:19.117Z",
          "trace_id": "trace_id"
        }
      ],
      "created_at": "2019-12-27T18:11:19.117Z",
      "endpoint_id": "endpoint_id",
      "event_id": "event_id",
      "event_kind": "event_kind",
      "observed_attempt_count": 0,
      "seq_from": 0,
      "seq_to": 0,
      "spent_attempt_count": 0,
      "state": "state",
      "chat_id": "chat_id"
    }
  ],
  "has_more": true,
  "older_successful_history_may_have_been_swept": true,
  "successful_history_incomplete_through": "2019-12-27T18:11:19.117Z",
  "next_cursor": "next_cursor"
}

Returns Examples

{
  "attempt_history_coverage_started_at": "2019-12-27T18:11:19.117Z",
  "data": [
    {
      "id": "id",
      "attempt_history_complete": true,
      "attempts": [
        {
          "attempt": 0,
          "attempt_completed_at": "2019-12-27T18:11:19.117Z",
          "attempt_started_at": "2019-12-27T18:11:19.117Z",
          "destination": "destination",
          "http_status": 0,
          "phase": "phase",
          "reason_code": "reason_code",
          "verdict": "verdict",
          "wire_completed_at": "2019-12-27T18:11:19.117Z",
          "wire_duration_ms": 0,
          "wire_started_at": "2019-12-27T18:11:19.117Z",
          "trace_id": "trace_id"
        }
      ],
      "created_at": "2019-12-27T18:11:19.117Z",
      "endpoint_id": "endpoint_id",
      "event_id": "event_id",
      "event_kind": "event_kind",
      "observed_attempt_count": 0,
      "seq_from": 0,
      "seq_to": 0,
      "spent_attempt_count": 0,
      "state": "state",
      "chat_id": "chat_id"
    }
  ],
  "has_more": true,
  "older_successful_history_may_have_been_swept": true,
  "successful_history_incomplete_through": "2019-12-27T18:11:19.117Z",
  "next_cursor": "next_cursor"
}