---
title: "Search AuditEvents"
method: POST
path: "/audit-event/_search"
tags: ["AuditEvent"]
---

# Search AuditEvents

`POST /audit-event/_search`

Search for `AuditEvents` with filtering capabilities.

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- object
  - `filter` AuditEventFilter, required — Filter object for AuditEvent
    - `equals` AuditEventFilterEquals — Equality/Inequality filter fields for AuditEvent
      - `id` string, uuid, nullable — Unique identifier for the AuditEvent
      - `meta` MetaFilterEquals — Equality/Inequality filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `createdBy` string, uuid, nullable — User who created the resource
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
        - `updatedBy` string, uuid, nullable — User who last updated the resource
      - `timestamp` string, date-time, nullable — The timestamp of the event
      - `resource` 'Group' | 'Guardian' | 'Employee' | 'EmployeePlacement' | 'Student' | 'StudentPlacement' — The resource that was affected by the audit event
      - `resourceID` string, uuid, nullable — The ID of the resource the event belongs to
      - `type` 'Delete' — The type of the audit event
    - `notEquals` AuditEventFilterEquals — Equality/Inequality filter fields for AuditEvent
      - `id` string, uuid, nullable — Unique identifier for the AuditEvent
      - `meta` MetaFilterEquals — Equality/Inequality filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `createdBy` string, uuid, nullable — User who created the resource
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
        - `updatedBy` string, uuid, nullable — User who last updated the resource
      - `timestamp` string, date-time, nullable — The timestamp of the event
      - `resource` 'Group' | 'Guardian' | 'Employee' | 'EmployeePlacement' | 'Student' | 'StudentPlacement' — The resource that was affected by the audit event
      - `resourceID` string, uuid, nullable — The ID of the resource the event belongs to
      - `type` 'Delete' — The type of the audit event
    - `greaterThan` AuditEventFilterRange — Range filter fields for AuditEvent
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `timestamp` string, date-time, nullable — The timestamp of the event
    - `smallerThan` AuditEventFilterRange — Range filter fields for AuditEvent
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `timestamp` string, date-time, nullable — The timestamp of the event
    - `greaterOrEqual` AuditEventFilterRange — Range filter fields for AuditEvent
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `timestamp` string, date-time, nullable — The timestamp of the event
    - `smallerOrEqual` AuditEventFilterRange — Range filter fields for AuditEvent
      - `meta` MetaFilterRange — Range filter fields for Meta
        - `createdAt` string, date-time, nullable — Timestamp when the resource was created
        - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `timestamp` string, date-time, nullable — The timestamp of the event
    - `contains` AuditEventFilterContains — Contains filter fields for AuditEvent
      - `id` string[] — Unique identifier for the AuditEvent
      - `meta` MetaFilterContains — Contains filter fields for Meta
        - `createdBy` string[] — User who created the resource
        - `updatedBy` string[] — User who last updated the resource
      - `resource` AuditEventResource[] — The type of resource the event occured for
      - `resourceID` string[] — The ID of the resource the event belongs to
      - `type` AuditEventType[] — The type of the audit event
    - `notContains` AuditEventFilterContains — Contains filter fields for AuditEvent
      - `id` string[] — Unique identifier for the AuditEvent
      - `meta` MetaFilterContains — Contains filter fields for Meta
        - `createdBy` string[] — User who created the resource
        - `updatedBy` string[] — User who last updated the resource
      - `resource` AuditEventResource[] — The type of resource the event occured for
      - `resourceID` string[] — The ID of the resource the event belongs to
      - `type` AuditEventType[] — The type of the audit event
    - `like` AuditEventFilterLike — LIKE filter fields for AuditEvent
      - `meta` MetaFilterLike — LIKE filter fields for Meta
    - `notLike` AuditEventFilterLike — LIKE filter fields for AuditEvent
      - `meta` MetaFilterLike — LIKE filter fields for Meta
    - `null` AuditEventFilterNull — Null filter fields for AuditEvent
      - `meta` MetaFilterNull — Null filter fields for Meta
        - `createdBy` boolean, nullable — User who created the resource
        - `updatedAt` boolean, nullable — Timestamp when the resource was last updated
        - `updatedBy` boolean, nullable — User who last updated the resource
    - `notNull` AuditEventFilterNull — Null filter fields for AuditEvent
      - `meta` MetaFilterNull — Null filter fields for Meta
        - `createdBy` boolean, nullable — User who created the resource
        - `updatedAt` boolean, nullable — Timestamp when the resource was last updated
        - `updatedBy` boolean, nullable — User who last updated the resource
    - `orCondition` boolean, required — OrCondition decides if this filter is within an OR-condition or AND-condition
    - `nestedFilters` AuditEventFilter[] — NestedFilters of the AuditEvent, useful for more complex filters

## Response `200`

Response for AuditEvent Search operation - returns filtered AuditEvent results

- object
  - `data` AuditEvent[] — Array of AuditEvent objects
    - `id` string, uuid, required — Unique identifier for the AuditEvent
    - `meta` Meta — Meta contains information about the creation and modification of a resource for auditing purposes
      - `createdAt` string, date-time, required — Timestamp when the resource was created
      - `createdBy` string, uuid, nullable — User who created the resource
      - `updatedAt` string, date-time, nullable — Timestamp when the resource was last updated
      - `updatedBy` string, uuid, nullable — User who last updated the resource
    - `timestamp` string, date-time, required — The timestamp of the event
    - `resource` 'Group' | 'Guardian' | 'Employee' | 'EmployeePlacement' | 'Student' | 'StudentPlacement', required — The resource that was affected by the audit event
    - `resourceID` string, uuid, required — The ID of the resource the event belongs to
    - `type` 'Delete', required — The type of the audit event
  - `pagination` Pagination — Pagination parameters for controlling result sets in list operations
    - `offset` integer, required — Number of items to skip from the beginning of the result set
    - `limit` integer, required — Maximum number of items to return in the result set
    - `total` integer, required — Total number of items available for pagination

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid parameters
- `401` — Unauthorized - The request is missing valid authentication credentials
- `403` — Forbidden - Request is authenticated, but the user is not allowed to perform the operation
- `404` — Not Found - The requested resource does not exist
- `409` — Conflict - The request could not be completed due to a conflict
- `422` — Validation error for AuditEvent Search operation - request data failed validation
- `429` — Too Many Requests - When the rate limit has been exceeded
- `500` — Internal Server Error - An unexpected server error occurred

---

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