---
title: "List Audit Logs"
method: GET
path: "/api/v2/audit_logs"
tags: ["Audit Logs"]
---

# List Audit Logs

`GET /api/v2/audit_logs`

#### Allowed For

* Admins on accounts that have audit log access

#### Pagination

* Cursor pagination (recommended)
* Offset pagination

See [Pagination](/api-reference/introduction/pagination/).

Returns a maximum of 100 records per page.

## Query parameters

- `page[before]` string
- `page[after]` string
- `page[size]` integer
- `filter[source_type]` string
- `filter[source_id]` integer
- `filter[actor_id]` integer
- `filter[ip_address]` string
- `filter[created_at]` string
- `filter[action]` string
- `sort` string

## Response `200`

Success response

- AuditLogsResponse
  - `audit_logs` AuditLogObject[]
    - `action` string — Type of change made. Possible values are "create", "destroy", "exported", "login", and "update"
    - `action_label` string — Localized string of action field
    - `actor_id` integer — id of the user or system that initiated the change
    - `actor_name` string — Name of the user or system that initiated the change
    - `change_description` string — The description of the change that occurred
    - `created_at` string, date-time — The time the audit got created
    - `id` integer — The id automatically assigned upon creation
    - `ip_address` string — The IP address of the user doing the audit
    - `source_id` integer — The id of the item being audited
    - `source_label` string — The name of the item being audited
    - `source_type` string — Item type being audited. Typically describes the system where the change was initiated. Possible values vary based on your account's Zendesk products and activity. Common values include "apitoken", "rule", "ticket", "user", and "zendesk/app_market/app". The "rule" value is used for [automations](https://support.zendesk.com/hc/en-us/articles/4408832701850), [macros](https://support.zendesk.com/hc/en-us/articles/4408844187034), [triggers](https://support.zendesk.com/hc/en-us/articles/4408822236058), [views](https://support.zendesk.com/hc/en-us/articles/4408888828570), and other automated business rules
    - `url` string — The URL to access the audit log

## Changes

> 29 revisions in range; 1 not diffed, 1 could not be searched.

- **2025-06-12** `edbf399da815` — 2 warning, 3 info
  - deleted the `query` request parameter `sort_by`
  - deleted the `query` request parameter `sort_order`
  - added the new optional `query` request parameter `page[after]`
  - added the new optional `query` request parameter `page[before]`
  - …1 more

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/audit_logs/get.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)