---
title: "Export organization audit events"
method: GET
path: "/v1/audit-events/export"
tags: ["Server"]
---

# Export organization audit events

`GET /v1/audit-events/export`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/audit-events/export`
- Auth: API key in header `x-api-key`

Export audit events for the authenticated organization as JSON or CSV. Only organization admins and full API keys may export. The default window is the last 90 days, with timezone-aware since/until bounds, newest-first keyset pagination, and a maximum page size of 500. CSV output uses fixed columns and is protected from spreadsheet formula execution.

## Query parameters

- `since` string, date-time, nullable
- `until` string, date-time, nullable
- `action` string, nullable
- `actor_user_id` string, nullable
- `resource_type` string, nullable
- `limit` integer
- `cursor` string, nullable
- `format` 'json' | 'csv'

## Response `200`

A page of audit events as JSON, or a CSV download when format=csv.

- AuditEventExportResponse
  - `rows` AuditEventExportRow[], required
    - `audit_event_id` string, required
    - `created_at` string, date-time, required
    - `organization_id` string, required
    - `actor_user_id` string, nullable, required
    - `impersonated_by` string, nullable, required
    - `auth_kind` string, required
    - `org_role` string, nullable, required
    - `action` string, required
    - `resource_type` string, required
    - `resource_id` string, nullable, required
    - `request_id` string, nullable, required
    - `details` object, required
  - `next` string, nullable, required

## Other responses

- `403`: The caller must be an organization admin or use a full API key.
- `422`: Validation Error

## Changes

- **2026-10-24** `aaf56481f696`: 1 info
  - added the required property `rows/items/impersonated_by` to the response with the `200` status
- **2026-10-24** `8d8088a49c6a`: 3 info
  - added the new optional `query` request parameter `action`
  - added the new optional `query` request parameter `actor_user_id`
  - added the new optional `query` request parameter `resource_type`
- **2026-10-20** `2a4986c670e4`: 2 info
  - added the optional property `detail/action` to the response with the `403` status
  - added the optional property `detail/role` to the response with the `403` status
- **2026-10-20** `539f04093540`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
- **2026-10-07** `ee3c528838cb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/audit-events/export/get.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) - [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/revisions/64479cb160ff?raw)