> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudgeni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit Logging

> Export and query audit logs for your organization.

# Audit Logging

Audit logs record actions taken in your organization. You can list, filter, and export them through the API or CLI.

## Endpoints

All endpoints are under `/api/v1/organizations/:orgId/audit-logs`.

### List audit logs

```
GET /audit-logs?limit=25&category=security&startDate=2026-01-01
```

Returns paginated results with `items`, `hasMore`, and `nextCursor` for cursor-based pagination.

### Export

```
GET /audit-logs/export?format=csv&startDate=2026-01-01&endDate=2026-04-01
```

Supported formats: `csv`, `json`, `ndjson`.

`csv` and `ndjson` stream results directly. `json` is more tightly capped and better for smaller exports.

### Export preflight

```
GET /audit-logs/export/preflight?format=csv&startDate=2026-01-01&endDate=2026-04-01
```

Returns estimated row count and byte size before you commit to a full export. Use this for large date ranges.

### Get single event

```
GET /audit-logs/:eventId
```

## CLI

```bash theme={null}
cloudgeni audit-log list --category security --start-date 2026-01-01
cloudgeni audit-log export --format csv --start-date 2026-01-01 --end-date 2026-04-01
```

CLI export streams output directly to stdout.