---
title: "List audit log entries. Administrators only"
method: GET
path: "/audit-logs"
tags: ["System"]
---

# List audit log entries. Administrators only

`GET /audit-logs`

## Request

- Base URL: `https://helpspot.example.com/api/v2`
- URL: `https://helpspot.example.com/api/v2/audit-logs`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

## Query parameters

- `offset` integer
- `per_page` integer

## Response `200`

Administrator-only audit records, newest ID first. created_at is UTC ISO 8601 (null for unset timestamps). staff_id preserves 0 (no staff) and -1 (system). string_value, decimal_value and details preserve stored text, including empty strings; details is not automatically decoded as JSON. Decimal values are strings to avoid precision loss.

- object
  - `data` object[], required
    - `id` integer
    - `action` string, nullable
    - `object` string, nullable
    - `staff_id` integer
    - `request_id` integer, nullable
    - `created_at` string, date-time, nullable
    - `integer_value` integer, nullable
    - `string_value` string, nullable
    - `decimal_value` string, nullable
    - `ip_address` string, nullable
    - `details` string, nullable
  - `meta` object, required
    - `offset` integer, required
    - `per_page` integer, required
    - `count` integer, required
    - `has_more` boolean, required
    - `next_offset` integer, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: An error
- `404`: Not Found
- `405`: Method Not Allowed
- `406`: Not Acceptable
- `413`: Content Too Large
- `422`: Validation error
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/helpspot/apis/helpspot-api-v2.md) · [All operations](https://skmtc.dev/helpspot/apis/helpspot-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/helpspot/apis/helpspot-api-v2/revisions/794dac0002c0?raw)