---
title: "Audit Logs"
method: GET
path: "/api/v1/audits"
tags: ["Beta Endpoints", "Audits"]
---

# Audit Logs

`GET /api/v1/audits`

_⚠️ This endpoint is in Beta_

This endpoint provides the same information that is available on the Audit Trail page.

## Query parameters

- `after_checkpoint` string
- `limit` integer

## Response `200`

Request was successfully processed

- object
  - `checkpoint` string, required — A token that can be used to get more audit entries.
  - `additional_results` boolean, required — True if there are more audit entries that can be immediately retrieved.
  - `results` AuditEvent[], required — Returns the audit entries in chronological order.
    - `timestamp` string, date-time, required — The time the event took place, in UTC.
    - `type` string, required — The type of the event.
    - `category` string, required — The category this event belongs to. Logically similar events will all belong to the same category
    - `details` string, required — Human-readable description of the event.
    - `user` string, email — The email address of the user who triggered the event.
    - `ip` union — The IP address of the client who triggered the event.
      - string, ipv4
      - string, ipv6

## Other responses

- `400` — There was a problem with the request
- `401` — There was a problem with the request
- `403` — Invalid token or API is not enabled
- `429` — Rate limited - wait a few seconds and try again
- `500` — Server error
- `503` — Server error
- `504` — Server error

---

[API](https://skmtc.net/tessian/apis/tessian-api.md) · [All operations](https://skmtc.net/tessian/apis/tessian-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tessian/tessian-api/revisions/08762fb51cf0/schema)