Skip to main content
GET
/
v1
/
admin
/
audit
/
logs
# All logs (paginated)
curl "https://portal-api.7331.org/v1/admin/audit/logs?limit=50" \
  -b "psession=YOUR_SESSION"

# Filter by event type
curl "https://portal-api.7331.org/v1/admin/audit/logs?event_type=USER_BAN" \
  -b "psession=YOUR_SESSION"
{
  "items": [
    {
      "id": 1,
      "entity_type": "user",
      "entity_id": 42,
      "event_type": "SUBSCRIPTION_GRANT",
      "actor_id": 7,
      "event_metadata": {
        "old_tier": 0,
        "new_tier": 2,
        "duration_days": 30
      },
      "created_at": "2026-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "offset": 0,
  "limit": 50
}

Documentation Index

Fetch the complete documentation index at: https://docs.7331.org/llms.txt

Use this file to discover all available pages before exploring further.

Requires an active session cookie with moderator or higher permissions. Moderators only see USER_WARN and USER_TIMEOUT events. Admins see all events except those targeting admin+ users.
offset
integer
default:"0"
Pagination offset.
limit
integer
default:"100"
Page size. Range: 1-200.
entity_type
string
Filter by entity type. One of: user, group, bot.
entity_id
integer
Filter by entity ID.
event_type
string
Filter by event type (e.g., SUBSCRIPTION_GRANT, USER_BAN, USER_UPDATE).
user_id
integer
Filter by admin ID who performed the action.

Response

items
object[]
required
Audit log entries.
total
integer
required
Total matching entries.
offset
integer
required
Offset used.
limit
integer
required
Page size used.
# All logs (paginated)
curl "https://portal-api.7331.org/v1/admin/audit/logs?limit=50" \
  -b "psession=YOUR_SESSION"

# Filter by event type
curl "https://portal-api.7331.org/v1/admin/audit/logs?event_type=USER_BAN" \
  -b "psession=YOUR_SESSION"
{
  "items": [
    {
      "id": 1,
      "entity_type": "user",
      "entity_id": 42,
      "event_type": "SUBSCRIPTION_GRANT",
      "actor_id": 7,
      "event_metadata": {
        "old_tier": 0,
        "new_tier": 2,
        "duration_days": 30
      },
      "created_at": "2026-01-15T12:00:00Z"
    }
  ],
  "total": 1,
  "offset": 0,
  "limit": 50
}