Webhook endpoints

List deliveries for a webhook endpoint

List recent deliveries for a webhook endpoint.

GET/v1/webhook-endpoints/{id}/deliveries
0credits
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
idstringrequiredpath

Webhook endpoint id.

min 1 chars

statusstringoptionalquery

Optional filter for delivery status.

one of: pending, success, failed

afterstringoptionalquery

ISO-8601 cursor (an earlier delivery's `createdAt`). When set, returns only strictly newer deliveries, oldest-first, for tailing — e.g. `socialfetch listen`. Omit for the usual newest-first page.

Response fields
19

Endpoint-specific response payload.

Delivery attempts for this webhook endpoint, most recent first.

datadeliveries[]id
string

Delivery attempt id.

min 1 chars

datadeliveries[]eventId
string

Id of the event this attempt delivered.

min 1 chars

datadeliveries[]endpointId
string

Id of the webhook endpoint this attempt targeted.

min 1 chars

datadeliveries[]attempt
integer

1-indexed attempt number for this event/endpoint pair.

≥ 0

datadeliveries[]status
string

Outcome of this delivery attempt.

one of: pending, success, failed

datadeliveries[]requestHeaders
object

The `socialfetch-*` headers sent with this delivery attempt.

datadeliveries[]payloadText
string

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`).

datadeliveries[]responseStatus
integernullable

HTTP status code returned by the endpoint, when available.

datadeliveries[]responseBodySnippet
stringnullable

Truncated response body from the endpoint, when available.

datadeliveries[]durationMs
integernullable

Duration of the delivery attempt in milliseconds.

datadeliveries[]manual
boolean

True for a customer- or dashboard-triggered redelivery, vs. the automatic retry ladder.

datadeliveries[]createdAt
string

ISO-8601 timestamp for when this delivery attempt was made.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

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.