Retrieve structured audit log entries for an organization with filtering, search, and pagination.
Returns a paginated list of audit entries tracking all mutations in your organization: role assignments, department changes, user management, and more. Supports filtering by entity type, action type, actor, date range, and full-text search.
organization_id string required
The unique identifier of the organization.
entity_type string optional
Filter by entity type. Values: user, department, role, role_assignment, department_membership, permission, knowledge_slice, vector_store, knowledge_grant, knowledge_composite.
action_type string optional
Filter by action type. Values: created, updated, deleted, invited, deactivated, reactivated, removed, assigned, unassigned, reparented, membership_added, membership_removed, and more.
actor_id string optional
Filter by the user who performed the action.
target_id string optional
Filter by the target entity of the action.
department_id string optional
Filter by department context.
from_date string optional
Filter entries from this date (ISO 8601 format, e.g. 2025-01-01).
to_date string optional
Filter entries until this date (ISO 8601 format, e.g. 2025-12-31).
search_term string optional
Full-text search across entity name, actor name, and actor email.
skip integer optional · Defaults to 0
Number of entries to skip for pagination.
limit integer optional · Defaults to 50
Number of entries to return per page. Maximum: 100.
Returns a paginated list of audit entries with total count and pagination metadata.
items— Array of audit entry objectstotal— Total number of entries matching all filtersskip— Current offsetlimit— Current page sizehas_more— Whether more entries exist beyond this page
- Bash
- Python
- Python
- JavaScript
curl -s -X GET "https://api.aitronos.com/v1/organizations/org_abc123/audit-log?entity_type=role&action_type=assigned&limit=10" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" | python3 -m json.tool