GET/v1/webhooks/deliveriesbeta

List deliveries

Needs: Read your data (mcp:read)
Plan: Any plan with API access
Limits: 300 a minute per key
Undo: Nothing to undo: this only reads.

Lists delivery attempts, newest first: which event went to which endpoint, and what your endpoint answered. The place to look when events seem missing.

Try it

Query (7)

endpoint_idoptionalstring

Only this endpoint.

status optional

pendingsucceededfailedexpired

Only these statuses.

response_classoptionalstring

`non2xx` includes no response at all.

fromoptionalstring

Start of the window (ISO 8601 with offset). Default: 7 days ago. Kept 30 days.

tooptionalstring

End of the window. Default: now.

cursoroptionalstring

The `next_cursor` from the previous page. Cursors expire after 24 hours.

limitoptionalinteger

How many items per page (1–100).

This only reads. It uses your real data and changes nothing.

curl -X GET 'https://mcp.wa-api.cloud/v1/webhooks/deliveries?status=failed' \
  -H "Authorization: Bearer $API_KEY"

The code reads your key from $API_KEY.

Parameters

Parameters
Field	Type	What it is
endpoint_id	string · query	Only this endpoint.pattern `^ep_[0-9A-HJKMNP-TV-Z]{26}$`Signed in? Pick one from your data with “My data”.
status	array of string · query	Only these statuses.1–4 items
response_class	string · query	`non2xx` includes no response at all.one of: `2xx`, `non2xx`
from	string · query	Start of the window (ISO 8601 with offset). Default: 7 days ago. Kept 30 days.date-time · pattern `^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z\|([+-](?:[01]\d\|2[0-3]):[0-5]\d)))$`
to	string · query	End of the window. Default: now.date-time · pattern `^(?:(?:\d\d[2468][048]\|\d\d[13579][26]\|\d\d0[48]\|[02468][048]00\|[13579][26]00)-02-29\|\d{4}-(?:(?:0[13578]\|1[02])-(?:0[1-9]\|[12]\d\|3[01])\|(?:0[469]\|11)-(?:0[1-9]\|[12]\d\|30)\|(?:02)-(?:0[1-9]\|1\d\|2[0-8])))T(?:(?:[01]\d\|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z\|([+-](?:[01]\d\|2[0-3]):[0-5]\d)))$`
cursor	string · query	The `next_cursor` from the previous page. Cursors expire after 24 hours.1–2048 characters
limit	integer · query	How many items per page (1–100).1–100 · default `25`

Headers

Headers
Field	Type	What it is
Authorizationrequired	header	`Bearer $API_KEY` — your API key.
Api-Version	header	The API version to use, e.g. `2026-10-01`. Default: the version your key is pinned to.one of: `2026-10-01` · pattern `^\d{4}-\d{2}-\d{2}$`

Response `200`

A page of deliveries.

Response fields
Field	Type	What it is
datarequired	array of object
idrequired	string
endpoint_idrequired	string
event_idrequired	string or null
statusrequired	string	pending \| succeeded \| failed \| expired
attemptrequired	number
response_statusrequired	number or null
latency_msrequired	number or null
created_atrequired	string or null
next_cursorrequired	string or null	Pass as "cursor" to get the next page; null when there are no more results.

Errors

Errors are application/problem+json. Branch on code.

Status	Code	When
400	invalid_input	A field is missing or has the wrong format. `errors[]` points at each field.
401	unauthenticated	The Authorization header is missing, the key is unknown, expired or revoked.
403	entitlement_required	The workspace's plan does not include API access (`api_access`).
403	insufficient_scope	The key does not have the permission this operation needs.
429	rate_limited	The key or workspace went over its rate limit. Wait for `Retry-After` seconds.
503	upstream_unavailable	A service behind the API is briefly unavailable. Safe to retry with backoff.

Examples

Failed deliveries this week

Response 200

{
  "data": [
    {
      "id": "del_01J8Z7C2E5H9K4M6P8R1S3V5XB",
      "endpoint_id": "ep_01J8Z6Q4M9W2X7K3B5N1R0T8YA",
      "event_id": "evt_01J8Z7BZQ4F6G8J2K5N7Q9S1VC",
      "status": "failed",
      "attempt": 2,
      "response_status": 500,
      "latency_ms": 812,
      "created_at": "2026-09-23T03:02:11Z"
    }
  ],
  "next_cursor": null
}

Operation path

The same operation is also at POST /v1/ops/webhooks_list_deliveries, with every field in the JSON body.