List Audit Logs
GET {{baseUrl}}/api/v2/audit_logs?filter[actor_id]={{actor_id}}&filter[action]={{action}}&filter[created_at]>{{created_at}}
Allowed For
- Admins on accounts that have audit log access
Pagination
- Cursor pagination (recommended)
- Offset pagination
See Pagination.
Returns a maximum of 100 records per page.
Request Params
| Key | Datatype | Required | Description | 
|---|---|---|---|
| filter[source_type] | string | Filter audit logs by the source type. For example, user or rule | |
| filter[source_id] | string | Filter audit logs by the source id. Requires filter[source_type]to also be set. | |
| filter[actor_id] | string | Filter audit logs by the actor id | |
| filter[ip_address] | string | Filter audit logs by the ip address | |
| filter[action] | string | Filter audit logs by the action | |
| sort_by | string | Offset pagination only. Sort audit logs. Default is sort_by=created_at | |
| sort_order | string | Offset pagination only. Sort audit logs. Default is sort_order=desc | |
| sort | string | Cursor pagination only. Sort audit logs. Default is sort=-created_at | |
| filter[created_at]>{{created_at}} | null | 
HEADERS
| Key | Datatype | Required | Description | 
|---|---|---|---|
| Accept | string | 
RESPONSES
status: OK
{"audit_logs":[{"action":"update","actor_id":1234,"actor_name":"Sameer Patel","change_description":"Role changed from Administrator to End User","created_at":"2012-03-05T11:32:44Z","id":498483,"ip_address":"209.119.38.228","source_id":3456,"source_label":"John Doe","source_type":"user","url":"https://company.zendesk.com/api/v2/audit_logs/498483.json"}]}