---
title: "Returns a list of audit log entries."
method: GET
path: "/logs/v0-nsfw/audit-logs"
tags: ["AuditLogs"]
---

# Returns a list of audit log entries.

`GET /logs/v0-nsfw/audit-logs`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/logs/v0-nsfw/audit-logs`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `logs.read`, `admin`

<br>You must have this scope: 'logs.read'.<br>For fine-grained clients, you must have this permission: 'core.audit_logs.read'.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `aggregateTypes` string[]
- `aggregateIds` string[]
- `entityTypes` string[]
- `entityIds` string[]
- `propertyIds` string[]
- `clientIds` string[]
- `subjectIds` string[]
- `actions` string[]
- `cursor` string
- `pageSize` integer

## Response `200`

Success.

- LogEntryListModel
  - `logs` LogEntryItemModel[], required: List of log entries
    - `id` string, uuid: The id of the log entry
    - `timestamp` string, date-time: The log entry timestamp<br />A date and time in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
    - `clientId` string, nullable: The client initiated the logged action
    - `subjectId` string, nullable: The subject (user) initiated the logged action
    - `actionType` 'Created' | 'Updated' | 'Deleted': The logged action type
    - `propertyId` string, nullable: The entity property
    - `aggregateType` string, nullable: The type of entity being tracked as a group. Example: If a unit maintenance is created, the AggregateType would be Unit.
    - `aggregateId` string, nullable: A unique identifier for a group of related changes. Use this to track multiple changes that belong to the same context or process. Example: If a unit maintenance is created, the AggregateId would be the unique ID of that unit.
    - `entityType` string, nullable: The type of the specific object that was changed. Example: If a unit maintenance is created, the EntityType would be Maintenance.
    - `entityId` string, nullable: A unique identifier for the specific object that was changed. Use this to track which exact item was updated within a group of changes. Example: If a unit maintenance is created, the EntityId would be the unique ID of that maintenance.
    - `previousData` object, nullable: The entity data before change
    - `currentData` object, nullable: The new entity data after change
  - `nextCursor` string, uuid, nullable: Cursor to the next page
  - `pageSize` integer, required: Size of the current page

## Other responses

- `204`: No audit log entries found.
- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-logs-api-not-safe-for-work.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-logs-api-not-safe-for-work/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-logs-api-not-safe-for-work/revisions/5a908bbb0d37?raw)