Delivery history

Recent deliveries, newest first (up to 100, kept for 30 days): event id and type, state (`delivered`, `retrying`, `failed`), the receiver’s HTTP status, total attempts, duration and, for a pending delivery, the next attempt time. The body and address are not kept in the history. On a transient failure (`429`, `5xx`, network) a delivery is tried 3 times at once, then again after 1 min, 5 min, 30 min, 2 h and 6 h (re-signed with a fresh timestamp each time, same `id`); `4xx` is not retried.

GET/v1/webhooks/{groupId}/deliveries

GETDelivery history

curl -X GET "https://api.darkradar.com/api/public/v1/webhooks/64b1f0c2a9e4d21f8c3b9a10/deliveries" \
  -H "x-api-key: $DARKRADAR_API_KEY"

Response

Success

{
  "success": true,
  "message": "OK",
  "data": {
    "deliveries": [
      {
        "id": "evt_12736aaa38942ca6e77d5c23",
        "type": "scan.finished",
        "state": "delivered",
        "ok": true,
        "status": 204,
        "attempts": 1,
        "durationMs": 42,
        "reason": null,
        "at": "2026-09-19T15:33:20.772Z",
        "nextAttemptAt": null
      },
      {
        "id": "evt_4cac069ffa3ac435ae861034",
        "type": "leak.created",
        "state": "retrying",
        "ok": false,
        "status": 503,
        "attempts": 3,
        "durationMs": 5112,
        "reason": "http_503",
        "at": "2026-09-19T15:31:02.108Z",
        "nextAttemptAt": "2026-09-19T15:32:02.108Z"
      }
    ]
  }
}

Access

Scopewebhooks:read

Plan entitlementapi_access

Path parameters

Fields	Values
`groupId` · string · required	Protection resource group id (24 hex chars) · Example: `64b1f0c2a9e4d21f8c3b9a10`

Query parameters

Fields	Values
`limit` · integer · optional	Max deliveries (1–100) · Example: `100`

Responses

200Success

400Invalid request (malformed id, missing or invalid field)

401Key missing, invalid, expired or revoked

403Insufficient scope, no API access in plan, or product not enabled

404Record not found or not owned by this key’s firm

408The request exceeded its maximum response time

429Rate limit exceeded; retry after a minute

Response limits

Page sizelimit · default 100 · max 100

Rate limit500 requests per 15 min · per IP

{ "success": true, "message": "OK", "data": { "deliveries": [ { "id": "evt_12736aaa38942ca6e77d5c23", "type": "scan.finished", "state": "delivered", "ok": true, "status": 204, "attempts": 1, "durationMs": 42, "reason": null, "at": "2026-09-19T15:33:20.772Z", "nextAttemptAt": null }, { "id": "evt_4cac069ffa3ac435ae861034", "type": "leak.created", "state": "retrying", "ok": false, "status": 503, "attempts": 3, "durationMs": 5112, "reason": "http_503", "at": "2026-09-19T15:31:02.108Z", "nextAttemptAt": "2026-09-19T15:32:02.108Z" } ] } }