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

# List audits

`GET /audits`

Retrieve audit information from your account ordered by most recent.

## Query parameters

- `created_at[gt]` integer
- `created_at[lt]` integer

## Response `200`

OK

- object
  - `data` object[]
    - `id` string, uuid
    - `event` string
    - `record_id` integer
    - `record_type` string
    - `created_at` string, date-time
    - `employee` EmployeeSimple
      - `id` integer, required
      - `active` boolean, required
      - `access` boolean
      - `employee_number` string
      - `full_name` string, required
      - `first_name` string
      - `middle_name` string
      - `last_name` string
      - `email` string, email
      - `personal_email` string, email
      - `mobile_number` string
      - `work_phone_number` string
      - `date_of_birth` string, date
      - `gender` 'male' | 'female'
      - `avatar_url` string
      - `probation_ends_on` string, date
      - `hired_on` string, date
      - `skype_username` string
      - `slack_username` string
      - `twitter_username` string
      - `facebook_url` string
      - `linkedin_url` string
      - `position` Position
        - `id` integer
        - `name` string
      - `job_level` JobLevel
        - `id` integer
        - `name` string
        - `created_at` string, date-time
        - `updated_at` string
      - `location` Location — Location model
        - `id` string, required
        - `name` string, required — Name of the location
      - `employment_type` EmploymentType — EmploymentType model
        - `id` string, required
        - `name` string, required — Name of the employment type
      - `division` Division
        - `id` integer
        - `name` string
      - `department` Department
        - `id` integer, required
        - `name` string, required
        - `parent_id` integer
        - `manager_id` integer — Employee ID for manager of the department
        - `department_level_id` integer — Department level ID
      - `reporting_to` ReportingTo
        - `id` integer, required
        - `first_name` string
        - `last_name` string
        - `email` string, email, required
    - `custom_table_fields` object
      - `column_id` object
        - `name` string
        - `value` string
  - `metadata` Pagination
    - `page` integer
    - `pages` integer
    - `count` integer
    - `items` integer

---

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