---
title: "Export audit events as CSV"
method: GET
path: "/orgs/{orgName}/events/export"
tags: ["Events"]
---

# Export audit events as CSV

`GET /orgs/{orgName}/events/export`

## Request

- Base URL: `https://api.signadot.com/api/v2`
- URL: `https://api.signadot.com/api/v2/orgs/{orgName}/events/export`
- Auth: API key in header `signadot-api-key`

Stream the org's audit events (same filters as the list endpoint) as a CSV attachment, newest first. The file is generated and streamed server-side with bounded memory, so the client need not page through every event; every event matching the filters is included.

## Path parameters

- `orgName` string, required

## Query parameters

- `startTime` string
- `endTime` string
- `type` string[]
- `filters` string
- `principalKind` string
- `principalId` string
- `authMethod` string

## Response `200`

CSV attachment

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-07-21** `ec90662095fb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signadot/apis/signadot-api/changes/orgs/:orgName/events/export/get.md)

---

[API](https://skmtc.dev/signadot/apis/signadot-api.md) - [All operations](https://skmtc.dev/signadot/apis/signadot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signadot/apis/signadot-api/revisions/5e80b0f9c718?raw)
