List webhook deliveries

{
  "data": [
    {
      "delivery_id": "dlv_9fK2mQ",
      "event": "message",
      "status": "delivered",
      "attempt_count": 1,
      "last_status_code": 200,
      "last_error": null,
      "next_attempt_at": null,
      "delivered_at": "2026-09-20T11:09:03Z",
      "created_at": "2026-09-20T11:09:02Z"
    },
    {
      "delivery_id": "dlv_7bX4tK",
      "event": "chat",
      "status": "failed",
      "attempt_count": 3,
      "last_status_code": 502,
      "last_error": "upstream returned 502",
      "next_attempt_at": "2026-09-20T11:24:00Z",
      "delivered_at": null,
      "created_at": "2026-09-20T11:08:11Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "total_count": 2,
    "has_more": false
  }
}

Inspect what we sent you and what happened — the answer to did you deliver that event?

Use it when an event you expected never arrived: find it by delivery_id, and the status, attempt_count and last_status_code say whether it reached you, is still being retried, or was given up on.

A dead_lettered delivery is one we have stopped retrying after the full schedule of 6 attempts. Reconcile a real gap with GET /v1/usage rather than relying on retries alone.

Message bodies are not included. This is a delivery log, not a second way to read your conversations.

Inspect what we sent you and what happened — the answer to *did you deliver that event?* Use it when an event you expected never arrived: find it by `delivery_id`, and the `status`, `attempt_count` and `last_status_code` say whether it reached you, is still being retried, or was given up on. A `dead_lettered` delivery is one we have stopped retrying after the full schedule of 6 attempts. **Reconcile a real gap with [`GET /v1/usage`](/api-reference/usage/list-usage) rather than relying on retries alone.** Message bodies are not included. This is a delivery log, not a second way to read your conversations.

Authentication

AuthorizationBearer

Your API key, issued by ParsChat sales. One key per account, spanning every robot you own. Send it as Authorization: Bearer pk_live_….

Query parameters

statusenumOptional

Restrict to one delivery state. Omit for all.

Allowed values:

limitintegerOptional1-100Defaults to 50

Page size, 1–100.

offsetintegerOptional>=0Defaults to 0

Deliveries to skip.

Response

A page of deliveries.

datalist of objectsOptional

paginationobjectOptional

Offset pagination. total_count tells you how many records match, so you know how many pages to fetch before you start.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error