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

# Exports

> Generate filtered CSV exports of your audit log data.

## 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

<Steps>
  <Step title="Create export">
    Send a `POST /api/v1/exports` request with optional filters. The API returns the export ID with status `pending`.
  </Step>

  <Step title="Processing">
    The export job runs in the background. Status changes to `processing`.
  </Step>

  <Step title="Download">
    When status is `completed`, request `GET /api/v1/exports/{id}/download`. The API returns a `302` redirect to a signed URL.
  </Step>
</Steps>

### Status Values

| Status       | Description                     |
| ------------ | ------------------------------- |
| `pending`    | Export is queued for processing |
| `processing` | Export is being generated       |
| `completed`  | Export is ready for download    |
| `failed`     | Export generation failed        |

## Filter Parameters

All filters are optional. Without filters, the export includes all events within your retention window.

| Parameter    | Type   | Description                                             |
| ------------ | ------ | ------------------------------------------------------- |
| `from`       | string | ISO 8601 timestamp. Export events from this time onward |
| `to`         | string | ISO 8601 timestamp. Export events up to this time       |
| `actor_id`   | string | Filter by actor identifier                              |
| `action`     | string | Filter by action                                        |
| `resource`   | string | Filter by resource type                                 |
| `tenant_id`  | string | Filter by tenant identifier                             |
| `session_id` | string | Filter by session identifier                            |
| `search`     | string | Case-insensitive search across event fields             |

## Example

<CodeGroup>
  ```bash cURL theme={null}
  # 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
  ```

  ```typescript JavaScript theme={null}
  const client = new ImmutableClient({
    apiKey: "imk_your_api_key_here",
    baseUrl: "https://getimmutable.dev",
  });

  // Create export
  const exportResult = await client.createExport({
    actor_id: "user_2hG9kLm",
    from: "2026-03-01T00:00:00Z",
    to: "2026-03-31T23:59:59Z",
  });

  // Poll for completion
  const status = await client.getExport(exportResult.id);
  ```

  ```php Laravel theme={null}
  use GetImmutable\AuditLog;

  $export = AuditLog::createExport([
      'actor_id' => 'user_2hG9kLm',
      'from' => '2026-03-01T00:00:00Z',
      'to' => '2026-03-31T23:59:59Z',
  ]);

  $status = AuditLog::getExport($export['data']['id']);
  ```
</CodeGroup>

## Limits

* Maximum **5 concurrent exports** per workspace
* Download URLs expire after **7 days**
* Each export counts toward your monthly export quota

<Warning>
  Events outside your [retention window](/platform/retention) are not included in exports. The export dialog displays a warning when your selected date range extends beyond the retention boundary.
</Warning>

## Plan Quotas

| Plan       | Monthly Exports |
| ---------- | --------------- |
| Free       | 3               |
| Starter    | 20              |
| Pro        | 100             |
| Enterprise | Unlimited       |