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.
X-API-Key
curl 'https://api.puntersedge.online/v1/webhooks' \
-H 'X-API-Key: YOUR_KEY'
This endpoint takes no parameters beyond authentication.
Status codes: 200, 401, 402, 422, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.
200 application/json
Field names and types are as the API returns them; values are a real sample, trimmed to a few items.
[
{
"id": "wh_7c1d2e9a4b3f",
"url": "https://example.com/hooks/puntersedge",
"events": [
"arb.opportunity",
"race.odds_open",
"race.result"
],
"min_edge_pct": 1.5,
"sports": [
"racing_horse",
"racing_greyhound",
"nrl"
],
"is_active": true,
"created_at": "2026-09-07T00:52:10",
"last_delivery_at": "2026-09-07T00:57:15",
"failure_count": 0,
"secret": null,
"delivery_entitled": true,
"delivery_paused_reason": null
}
]
POST /v1/webhooks — Create WebhookDELETE /v1/webhooks/{webhook_id} — Delete WebhookGET /v1/webhooks/{webhook_id}/deliveries — List Webhook DeliveriesPOST /v1/webhooks/{webhook_id}/replay — Replay WebhookPOST /v1/webhooks/{webhook_id}/resume — Resume WebhookPOST /v1/webhooks/{webhook_id}/rotate-secret — Rotate Webhook SecretPOST /v1/webhooks/{webhook_id}/test — Test WebhookThe free tier needs no credit card, and the sandbox endpoints need no key at all.
Get a free API key Quickstart