API documentation

List the audit log

Your firm’s Threat Investigation actions, newest first: who (user or API key), when, target type, credits spent and result count. Email, username, computer name and hardware ID targets are masked; IP and browser details are not returned. Spends no credits.

GET/v1/hunter/audit
GETList the audit log
curl -X GET "https://api.darkradar.com/api/public/v1/hunter/audit" \
  -H "x-api-key: $DARKRADAR_API_KEY"
Response

Success

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "64b1f0c2a9e4d21f8c3b9a50",
        "createdAt": "2026-10-30T09:12:00.000Z",
        "actorKind": "apikey",
        "apiKeyId": "64b1f0c2a9e4d21f8c3b9a01",
        "action": "query",
        "targetKind": "email",
        "targetValue": "a***@darkradar.com",
        "creditsSpent": 0,
        "resultCount": 4
      }
    ],
    "total": 1
  }
}

Access

Scopehunter:search
Plan entitlementintel_hunter

Query parameters

FieldsValues
from · string · optionalFrom (ISO 8601) · Example: 2026-10-01
to · string · optionalTo (ISO 8601) · Example: 2026-10-31
action · string · optionalAction · Values: query, target.add, target.remove, unmask, export · Example: query
apiKeyId · string · optionalOnly this API key · Example: 64b1f0c2a9e4d21f8c3b9a01
limit · integer · optionalMax records (1–500) · 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 500
Rate limit500 requests per 15 min · per IP
Threat Investigation20 requests per 1 min · per firm

Was this page helpful?