---
title: "List User Audits"
method: GET
path: "/users/"
tags: ["Audits"]
---

# List User Audits

`GET /users/`

Retrieve a list of user audits.

## Query parameters

- `date_from` string, date-time — Only include user audits created on or after this timestamp. Must be an ISO 8601 datetime in UTC (applied to the `created_at` field).
- `date_to` string, date-time — Only include user audits created on or before this timestamp. Must be an ISO 8601 datetime in UTC (applied to the `created_at` field).
- `action` 'USER_LOGIN' | 'USER_LOGIN_FAILED' | 'USER_UPDATE' | 'USER_LOGOUT'
- `limit` integer
- `cursor` string

## Headers

- `x-company-id` integer — ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Response `200`

Successful Response

- ListUserAuditsResponse
  - `next_cursor` string
  - `has_more` boolean
  - `status` 'success'
  - `data` UserAuditResult[], required
    - `id` integer
    - `created_at` string, date-time
    - `action` 'USER_LOGIN' | 'USER_LOGIN_FAILED' | 'USER_UPDATE' | 'USER_LOGOUT'
    - `description` string
    - `ip_address` string
    - `user` UserDTO
      - `id` integer
      - `username` string
      - `first_name` string
      - `last_name` string
      - `email` string

## Other responses

- `403` — Forbidden
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/infiniaweb/apis/payins.md) · [All operations](https://skmtc.net/infiniaweb/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infiniaweb/payins/revisions/3f453785c478/schema)