Skip to main content
GET
/
admin
/
audit-logs
Query audit logs
curl --request GET \
  --url https://api.engagefabric.com/admin/audit-logs
{
  "items": [
    {
      "id": "<string>",
      "actorType": "USER",
      "actorId": "<string>",
      "eventType": "AUTH_LOGIN",
      "eventCategory": "AUTHENTICATION",
      "action": "<string>",
      "resource": "<string>",
      "status": "SUCCESS",
      "severity": "DEBUG",
      "isSuspicious": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "tenantId": "<string>",
      "projectId": "<string>",
      "actorIp": "<string>",
      "resourceId": "<string>",
      "details": {},
      "changes": {},
      "metadata": {},
      "errorMessage": "<string>",
      "flagReason": "<string>"
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123,
  "totalPages": 123
}

Query Parameters

​
tenantId
string

Filter by tenant ID

​
projectId
string

Filter by project ID

​
actorType
enum<string>

Filter by actor type

Available options:
USER,
API_KEY,
SYSTEM,
WEBHOOK,
PLAYER
​
actorId
string

Filter by actor ID

​
eventType
enum<string>

Filter by event type

Available options:
AUTH_LOGIN,
AUTH_LOGOUT,
AUTH_FAILED_LOGIN,
AUTH_TOKEN_CREATED,
AUTH_TOKEN_REVOKED,
TENANT_CREATED,
TENANT_UPDATED,
TENANT_DELETED,
PROJECT_CREATED,
PROJECT_UPDATED,
PROJECT_DELETED,
PROJECT_TIER_CHANGED,
PLAYER_CREATED,
PLAYER_UPDATED,
PLAYER_DELETED,
PLAYER_BANNED,
PLAYER_UNBANNED,
XP_GRANTED,
LEVEL_UP,
CURRENCY_GRANTED,
CURRENCY_DEDUCTED,
BADGE_AWARDED,
LIVES_UPDATED,
RULE_CREATED,
RULE_UPDATED,
RULE_DELETED,
RULE_PUBLISHED,
RULE_EXECUTED,
QUEST_CREATED,
QUEST_UPDATED,
QUEST_COMPLETED,
ADVENTURE_CREATED,
ADVENTURE_STARTED,
ADVENTURE_COMPLETED,
RATE_LIMIT_EXCEEDED,
RATE_LIMIT_RESET,
RATE_LIMIT_OVERRIDE_CREATED,
IP_BLOCKED,
IP_UNBLOCKED,
ABUSE_DETECTED,
ADMIN_OVERRIDE,
ADMIN_DATA_EXPORT,
ADMIN_CONFIG_CHANGE,
ADMIN_MANUAL_ADJUSTMENT,
SECURITY_SUSPICIOUS_ACTIVITY,
SECURITY_API_KEY_LEAKED,
SECURITY_UNAUTHORIZED_ACCESS,
SECURITY_IP_BLOCKED,
SECURITY_IP_UNBLOCKED
​
eventCategory
enum<string>

Filter by event category

Available options:
AUTHENTICATION,
AUTHORIZATION,
DATA_ACCESS,
DATA_MUTATION,
CONFIGURATION,
SECURITY,
COMPLIANCE,
ADMIN_ACTION,
SYSTEM_EVENT
​
resource
string

Filter by resource type

​
resourceId
string

Filter by resource ID

​
severity
enum<string>

Filter by severity

Available options:
DEBUG,
INFO,
WARNING,
ERROR,
CRITICAL
​
suspiciousOnly
boolean
default:false

Filter suspicious only

​
startDate
string

Start date (ISO 8601)

​
endDate
string

End date (ISO 8601)

​
page
number
default:1

Page number

Required range: x >= 1
​
limit
number
default:50

Items per page

Required range: 1 <= x <= 100

Response

200 - application/json

Paginated audit logs

​
items
object[]
required
​
total
number
required
​
page
number
required
​
limit
number
required
​
totalPages
number
required