---
title: "Get audit logs (Paginated)"
method: GET
path: "/audit-trail"
tags: ["Audit Trail"]
---

# Get audit logs (Paginated)

`GET /audit-trail`

Returns a paginated object of audit logs.

## Query parameters

- `actor` string
- `entityName` string
- `entity` string, required
- `action` string
- `ids` string
- `id` string
- `changeReason` string
- `from` string, date-time, required
- `to` Schema, required — unresolved $ref
- `take` number
- `skip` number
- `format` 'json' | 'csv'

## Response `200`

Complex object containing audit logs and paging information.

- object
  - `skip` number
  - `take` number
  - `next` boolean
  - `logs` object[]
    - `id` string, uuid
    - `orgSlug` string
    - `ip` string, ipv4
    - `createdAt` string, date-time
    - `entity` object
      - `id` Id — unresolved $ref
      - `type` 'user' | 'file' | 'datahub-agent' | 'iot-source' | 'user-setting' | 'db-credentials' | 'feature-flag'
      - `before` object
      - `after` object
      - `schemaVersion` number
    - `action` 'create' | 'update' | 'delete' | 'enable' | 'disable' | 'unlock' | 'change-role' | 'change-password' | 'login-attempt' | 'copy' | 'change-default-role' | 'reset-password' | 'forgot-password-request' | 'expired-token'
    - `actor` object
      - `id` Id — unresolved $ref
      - `type` 'user' | 'service-user' | 'local-user'
      - `name` string
      - `email` string, email
    - `authToken` object
      - `ending` string

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/revisions/0205e2bace53/schema)