---
title: "List Audit Logs in Account"
method: GET
path: "/v1/workspaces/{workspace_id}/governance/audit_logs"
tags: ["Reports"]
---

# List Audit Logs in Account

`GET /v1/workspaces/{workspace_id}/governance/audit_logs`

## Request

- Base URL: `https://api.oxvo.com`
- URL: `https://api.oxvo.com/v1/workspaces/{workspace_id}/governance/audit_logs`
- Auth: API key in header `api_access_token`

Get Details of Audit Log entries for an Account. This endpoint is only available in Enterprise editions and requires the audit_logs feature to be enabled.

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Success

- object
  - `data` object
    - `items` AuditLog[]: Array of audit log entries
      - `id` integer: Unique identifier for the audit log entry
      - `auditable_id` integer: The ID of the audited object
      - `auditable_type` string: The type of the audited object (e.g., Conversation, Contact, User)
      - `auditable` object: The audited object data
      - `associated_id` integer: The ID of the associated object (typically the account ID)
      - `associated_type` string: The type of the associated object
      - `user_id` integer: The ID of the user who performed the action
      - `user_type` string: The type of user who performed the action
      - `username` string: The email/username of the user who performed the action
      - `action` 'create' | 'update' | 'destroy': The action performed on the object
      - `audited_changes` object: JSON object containing the changes made to the audited object
      - `version` integer: Version number of the audit log entry
      - `comment` string, nullable: Optional comment associated with the audit log entry
      - `request_uuid` string: UUID to identify the request that generated this audit log
      - `created_at` integer: Unix timestamp when the audit log entry was created
      - `remote_address` string, nullable: IP address from which the action was performed
  - `meta` object
    - `page` object
      - `number` integer: Current page number
      - `size` integer: Number of items per page
      - `total_items` integer: Total number of audit log entries

## Other responses

- `403`: Access denied
- `422`: Feature not enabled or not available in current plan

---

[API](https://skmtc.dev/oxvo/apis/oxvo-apis.md) · [All operations](https://skmtc.dev/oxvo/apis/oxvo-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/oxvo/apis/oxvo-apis/revisions/9a8448cbd1fe?raw)