## 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 Parameters - `cursor: optional string` - `delivery_id: optional string` - `endpoint_id: optional string` - `event_id: optional string` - `event_kind: optional string` - `from: optional string` - `limit: optional number` - `outcome: optional string` - `to: optional string` - `trace_id: optional string` ### Returns - `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. - `data: array of Delivery` - `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: number` The spent attempt number. Gaps mean a lease expired without an applied verdict. - `attempt_completed_at: string` - `attempt_started_at: string` - `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. - `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` - `wire_duration_ms: number` - `wire_started_at: string` - `trace_id: optional string` W3C trace id when one was recorded. Correlation only; never authorization. - `created_at: string` - `endpoint_id: string` - `event_id: string` - `event_kind: string` - `observed_attempt_count: number` Applied attempt verdicts retained below. - `seq_from: number` - `seq_to: number` - `spent_attempt_count: number` Attempts spent by the delivery machine, including leases that expired without an applied verdict. - `state: string` `pending`, `delivering`, `delivered`, `permanent_refusal`, or `retry_exhausted`. - `chat_id: optional string` - `next_attempt_at: optional string` Present only while `state` is `pending`: the instant the next attempt becomes due. A value in the future is a delivery backing off after a failed attempt; a value at or before now is a delivery that is due and waiting — usually behind an earlier delivery to the same endpoint and chat. Deliveries to one endpoint and chat are sent in the order their events were recorded. A `message.received` for a message carrying attachments can be recorded once every attachment has been captured or has failed, or ten minutes after the message arrived. It can therefore follow deliveries for later messages of the same chat, and carry a lower `data.seq_from` than an event you already received: `seq_from` can decrease relative to arrival. Never discard such an event as stale: deduplicate by the event `id`, order a conversation by `data.seq_from`, and for live processing buffer briefly or reconcile with `GET /v1/chats/{chat}/events`. `POST /v1/webhook_deliveries/{delivery}/retry` moves a future value to now. - `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. - `next_cursor: optional string` ### Example ```http curl https://whatsapp.messages.api.linqapp.com/v1/webhook_deliveries \ -H "Authorization: Bearer $LINQ_WHATSAPP_API_KEY" ``` #### Response ```json { "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", "next_attempt_at": "2019-12-27T18:11:19.117Z" } ], "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" } ```