Webhooks

List Webhook Deliveries

Your subscription's delivery log, newest first.

With no parameters this is the newest 50 rows, exactly as it has always been. since, status, limit (up to 200) and cursor page through older rows: when a page is full the response carries an X-Next-Cursor header to pass back as cursor. include=attempts adds an attempts list to each row (time, status code, error and latency of every POST), filled for rows written by the delivery queue.

Delivery is at-least-once: the same event can arrive more than once, so deduplicate on event_id (in the body, and sent as the X-PuntersEdge-Id and Idempotency-Key headers). There is no ordering guarantee between events. Each delivery carries X-PuntersEdge-Timestamp, X-PuntersEdge-Attempt and two signatures: X-Webhook-Signature: sha256=<hex> (HMAC-SHA256 of the raw body with your secret) and X-PuntersEdge-Signature: t=<unix seconds>,v1=<hex> (HMAC-SHA256 of <t>.<raw body>; refuse a t more than 5 minutes from now to block replays). Any 2xx answer is success. A 5xx, 408, 429, timeout or connection failure is retried after 1 min, 5 min, 30 min, 2 h, 6 h (6 tries in all, about 8.5 hours), honouring Retry-After up to the next step; any other answer is final. After 10 consecutive undeliverable events, or a day of continuous failure, the subscription is paused and the owner is emailed; POST /v1/webhooks/{id}/resume restarts it with the same secret, and POST /v1/webhooks/{id}/replay re-sends what was missed. The delivery log returns the newest 50 rows unless limit says otherwise.

get/v1/webhooks/{webhook_id}/deliveries

Request

  • Base URL: https://api.puntersedge.online
  • URL: https://api.puntersedge.online/v1/webhooks/{webhook_id}/deliveries
  • Auth: API key in header X-API-Key

Path parameters

webhook_idstring required

Query parameters

sincestring nullable

Only rows recorded at or after this ISO-8601 time, e.g. 2026-10-13T06:00:00Z.

statusstring nullable

Only rows with this status.

limitinteger

Rows per page, newest first (max 200).

cursorstring nullable

The X-Next-Cursor response header of the previous page, to read the next one.

includestring nullable

attempts adds each row's per-attempt detail.

Headers

X-API-Keystring
X-RapidAPI-Proxy-Secretstring

Response

Successful Response

idstring required
webhook_idstring required
event_typestring required
payloadunknown required
statusstring

delivered (receiver answered 2xx) or failed (every attempt refused or the answer was final, see error). Rows written before 2026-09-03 read pending.

attempt_countinteger

POST attempts made for this row: at most 2, or at most 6 when the delivery queue is enabled.

status_codeinteger nullable required
errorstring nullable required
delivered_atstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.