Get audit logs

Request: No body - filters passed as query parameters

Returns paginated audit logs with human-readable descriptions. Optionally filter by action type using the action query param (values from AuditLogs constants e.g. user_logged_in, tarot_action). Admin role required.

Query params: limit (1–100, default 20), offset (default 0), optional action

Success: 200 - data.logs[] (each: full_name, email, action, description, meta_data, ip_address, user_agent, created_at) plus data.total, data.limit, data.offset.

Errors: 401 - missing/invalid token | 403 - not an admin

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Audit logs fetched successfully",
    "data": {
        "logs": [
            {
                "full_name": "Rahul Sharma",
                "email": "rahul@example.com",
                "action": "user_logged_in",
                "description": "Rahul Sharma logged in",
                "meta_data": {
                    "device": "mobile"
                },
                "ip_address": "103.21.58.1",
                "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0)",
                "created_at": "2026-05-13T10:30:00Z"
            }
        ],
        "total": 120,
        "limit": 20,
        "offset": 0
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

Request

Request Code Samples

Responses