Skip to main content

​
Overview

Export your audit log events as CSV files. Exports are processed in the background and produce a signed download URL that expires after 7 days.

​
Export Lifecycle

1

Create export

Send a POST /api/v1/exports request with optional filters. The API returns the export ID with status pending.
2

Processing

The export job runs in the background. Status changes to processing.
3

Download

When status is completed, request GET /api/v1/exports/{id}/download. The API returns a 302 redirect to a signed URL.

​
Status Values

StatusDescription
pendingExport is queued for processing
processingExport is being generated
completedExport is ready for download
failedExport generation failed

​
Filter Parameters

All filters are optional. Without filters, the export includes all events within your retention window.
ParameterTypeDescription
fromstringISO 8601 timestamp. Export events from this time onward
tostringISO 8601 timestamp. Export events up to this time
actor_idstringFilter by actor identifier
actionstringFilter by action
resourcestringFilter by resource type
tenant_idstringFilter by tenant identifier
session_idstringFilter by session identifier
searchstringCase-insensitive search across event fields

​
Example

# Create export
curl -X POST https://getimmutable.dev/api/v1/exports \
  -H "Authorization: Bearer imk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "actor_id": "user_2hG9kLm",
    "from": "2026-03-01T00:00:00Z",
    "to": "2026-03-31T23:59:59Z"
  }'

# Check status
curl https://getimmutable.dev/api/v1/exports/exp_9c2f4a7b... \
  -H "Authorization: Bearer imk_your_api_key_here"

# Download when completed
curl -L https://getimmutable.dev/api/v1/exports/exp_9c2f4a7b.../download \
  -H "Authorization: Bearer imk_your_api_key_here" \
  -o audit_export.csv

​
Limits

  • Maximum 5 concurrent exports per workspace
  • Download URLs expire after 7 days
  • Each export counts toward your monthly export quota
Events outside your retention window are not included in exports. The export dialog displays a warning when your selected date range extends beyond the retention boundary.

​
Plan Quotas

PlanMonthly Exports
Free3
Starter20
Pro100
EnterpriseUnlimited