Skip to navigation

List webhook deliveries

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.

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
500
Internal Server Error
503
Service Unavailable Error