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/auditGETList the audit logcurl -X GET "https://api.darkradar.com/api/public/v1/hunter/audit" \ -H "x-api-key: $DARKRADAR_API_KEY"
Response
{
"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
}
}Query parameters
| Fields | Values |
|---|---|
from · string · optional | From (ISO 8601) · Example: 2026-10-01 |
to · string · optional | To (ISO 8601) · Example: 2026-10-31 |
action · string · optional | Action · Values: query, target.add, target.remove, unmask, export · Example: query |
apiKeyId · string · optional | Only this API key · Example: 64b1f0c2a9e4d21f8c3b9a01 |
limit · integer · optional | Max records (1–500) · Example: 100 |
Responses
200Success400Invalid request (malformed id, missing or invalid field)401Key missing, invalid, expired or revoked403Insufficient scope, no API access in plan, or product not enabled404Record not found or not owned by this key’s firm408The request exceeded its maximum response time429Rate limit exceeded; retry after a minuteResponse limits
Page sizelimit · default 100 · max 500
Rate limit500 requests per 15 min · per IP
Threat Investigation20 requests per 1 min · per firm