Query Audit Logs

Query Audit Logs

Paginated query of audit log entries. Scoped by the authenticated user’s merchant context. Supports filtering by:

• merchantId — merchant identifier
• subjectId — customer/subject identifier (exact)
• actorId — the user who performed the action (exact)
• subjectName — customer/subject name or email (partial, case-insensitive)
• actorName — actor’s name, email, or username (partial, case-insensitive)
• merchantName — merchant program name (partial, case-insensitive)
• action — one or more AuditAction values (e.g. pii_access, login_failed)
• resourceType — one or more AuditResourceType values
• from / to — ISO 8601 datetime range
• page / limit — pagination (max 200 per page)

MERCHANT_ADMIN and MERCHANT_STAFF can query. If merchantId is omitted, defaults to the program ID from the authenticated session.