---
title: "List Audit Logs (Offset Pagination)"
method: GET
path: "/api/external/audit"
tags: ["Audit Log API"]
---

# List Audit Logs (Offset Pagination)

`GET /api/external/audit`

Audit Logs can be filtered specifying a date interval.<br> Maximum number of Audit Logs that will be received per page is 200. <br> If there are more Audit Logs on the specified date interval, the total number of pages will be returned for further querying.<br/><br/>**NOTE:** The **USE AUDIT LOGS API** permission must be enabled.<br>

## Query parameters

- `pageNumber` integer
- `pageSize` integer
- `from` string, date-time
- `to` string, date-time

## Response `200`

OK

- AuditLogEventExternal
  - `content` AuditLogExternalTransport[]
    - `diffPayload` DiffPayloadExternalTransport
      - `newValue` string
      - `oldValue` string
    - `event` string
    - `ipAddress` string
    - `message` object
    - `port` string
    - `timestamp` string, date-time
    - `userId` string
    - `userRole` string
  - `pageSize` integer
  - `pageNumber` integer
  - `totalCount` integer

## Other responses

- `204` — No Content
- `400` — Bad Request
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/celonis/apis/celonis-audit-log-api.md) · [All operations](https://skmtc.dev/celonis/apis/celonis-audit-log-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/celonis/celonis-audit-log-api/revisions/edd68e17c453/schema)