---
title: "Get filtered audit log events based on specific types and categories for your organization, limited to 500 records"
method: POST
path: "/api/v1/audit-log/events"
tags: ["client-api-audit-log-rest-resource"]
---

# Get filtered audit log events based on specific types and categories for your organization, limited to 500 records

`POST /api/v1/audit-log/events`

## Request

- Base URL: `https://app.visotrust.com`
- URL: `https://app.visotrust.com/api/v1/audit-log/events`
- Auth: none declared
- TypeScript: <https://skmtc.dev/visotrust/apis/viso-trust-api-documentation/docs/api/v1/audit-log/events/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- AuditLogFilterRequest: Request for filtering audit log events by specific types
  - `start` string, date-time, required: Start date for the audit log query
  - `end` string, date-time, required: End date for the audit log query
  - `eventTypes` string[]: Set of specific event types to retrieve. If null or empty, returns all event types. Allowed values (by category): USER_: USER_LOGGED_IN, USER_LOGGED_OUT, EXISTING_USER_FIRST_LOG_IN, NEW_USER_FIRST_LOG_IN, USER_UPLOADED_ARTIFACT, USER_DOWNLOADED_ARTIFACT, USER_EXPORTED_ARTIFACT, USER_CREATED, USER_UPDATED, USER_SUBSCRIBED, USER_UNSUBSCRIBED, USER_DEFAULT_SUBSCRIBER_ADDED, USER_DEFAULT_SUBSCRIBER_REMOVED ORG_: ORG_CREATED, ORG_UPDATED, ORG_FIRST_LOGIN, ORG_OFFBOARD_IN_PROGRESS, ORG_OFFBOARD_SUCCESS, ORG_OFFBOARD_FAILED, ORG_SUBDOMAIN_SET, ORG_ASSESSMENT_DEFAULTS_CREATED, ORG_ASSESSMENT_DEFAULTS_UPDATED ASSESSMENT_: ASSESSMENT_CREATED, ASSESSMENT_UPDATED, ASSESSMENT_COMPLETED, ASSESSMENT_CANCELLED, ASSESSMENT_CANCELLED_BY_VENDOR, ASSESSMENT_CANCELLED_BY_CLIENT, ASSESSMENT_CANCELLED_BY_AUDITOR, ASSESSMENT_CANCELLED_BY_ADMIN, ASSESSMENT_AUTOMATICALLY_CANCELLED, ASSESSMENT_EXPIRED, ASSESSMENT_AUDIT_COMPLETED, ASSESSMENT_STATUS_CHANGED RELATIONSHIP_: RELATIONSHIP_CREATED, RELATIONSHIP_ARCHIVED, RELATIONSHIP_ONBOARDED, RELATIONSHIP_UPDATED, RISK_ACCEPTED, RISK_ACCEPTANCE_REVOKED, PRIMARY_CONTACT_CHANGED

## Response `200`

OK

- AuditEvent[]
  - `auditEventType` AuditEventType
    - `name` string
  - `dateTime` string, date-time

---

[API](https://skmtc.dev/visotrust/apis/viso-trust-api-documentation.md) - [All operations](https://skmtc.dev/visotrust/apis/viso-trust-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/visotrust/apis/viso-trust-api-documentation/revisions/98c8d5d102c9?raw)