---
title: "Get unified audit log"
method: GET
path: "/internal/api/clients/{client_id}/dms/audit"
tags: ["CLIENT", "Client Document Management", "DMS Audit"]
---

# Get unified audit log

`GET /internal/api/clients/{client_id}/dms/audit`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/clients/{client_id}/dms/audit`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Get comprehensive audit trail for all client and DMS operations with pagination and filtering

## Path parameters

- `client_id` string, uuid, required: Client ID

## Query parameters

- `action` string, nullable: Filter by action
- `action_type` string, nullable: Filter by action type
- `entity_type` string, nullable: Filter by entity type
- `risk_level` string, nullable: Filter by risk level
- `user_id` string, uuid, nullable: Filter by user ID
- `start_date` string, date-time, nullable: Filter by start date
- `end_date` string, date-time, nullable: Filter by end date
- `page` integer: Page number (1-based)
- `page_size` integer: Number of items per page (max 100)
- `sort_by` 'created_at' | 'name' | 'email' | 'readable_id' | 'filing_type' | 'filing_status': Client sort field enumeration
- `sort_order` 'asc' | 'desc': Sort order enumeration
- `search_query` string, nullable: Search term

## Response `200`

Successful Response

- AuditLogResponse: Audit log response using generic pagination structure with meta object
  - `audit_entries` AuditLogItem[], required: List of audit log entries
    - `id` string, uuid, required
    - `action` string, required
    - `document_id` string, uuid, nullable, required
    - `folder_id` string, uuid, nullable, required
    - `user_id` string, uuid, required
    - `timestamp` string, date-time, required
    - `details` object, nullable, required
    - `reason` string, nullable, required
    - `ip_address` string, nullable: IP address of the user
    - `user_agent` string, nullable: User agent string
    - `session_id` string, nullable: Session ID
  - `meta` AppSchemasDmsAuditPaginationMeta, required: Pagination metadata
    - `page` integer, required: Current page number
    - `page_size` integer, required: Number of items per page
    - `total_count` integer, required: Total number of items
    - `total_pages` integer, required: Total number of pages

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)