List deliveries for a webhook endpoint
List recent deliveries for a webhook endpoint.
Headers
Get your API keyAPI key (`sfk_...`)
Webhook endpoint id.
min 1 chars
Optional filter for delivery status.
one of: pending, success, failed
Maximum deliveries to return (1–100). Default: 25.
≥ 1 · ≤ 100
Opaque pagination cursor from a previous response's `data.page.nextCursor`. Prefer this over `after` for continuation.
min 1 chars
ISO-8601 entry point for tail mode (oldest-first, strictly newer than this timestamp) — e.g. `socialfetch listen`. Use `cursor` to continue after the first page. When both `cursor` and `after` are set, `cursor` wins.
Endpoint-specific response payload.
Delivery attempts for this webhook endpoint. Newest-first by default; oldest-first when entered via `after` (tail mode).
Delivery attempt id.
min 1 chars
Id of the event this attempt delivered.
min 1 chars
Id of the webhook endpoint this attempt targeted.
min 1 chars
1-indexed attempt number for this event/endpoint pair.
≥ 0
Outcome of this delivery attempt.
one of: pending, success, failed
The `socialfetch-*` headers sent with this delivery attempt.
The exact request body bytes sent (and signed) for this attempt — byte-identical across every attempt of the same event. Forward this verbatim to reproduce a signed delivery locally (e.g. `socialfetch listen`).
HTTP status code returned by the endpoint, when available.
Truncated response body from the endpoint, when available.
Duration of the delivery attempt in milliseconds.
True for a customer- or dashboard-triggered redelivery, vs. the automatic retry ladder.
ISO-8601 timestamp for when this delivery attempt was made.
Pagination state for the current page. Pass `nextCursor` as `cursor` to continue in the same direction.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/webhook-endpoints/abc123/deliveries" \
-H "x-api-key: YOUR_API_KEY"Responses
Delivery attempts for the requested webhook endpoint.