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

# Create Export

> Generate a filtered CSV export of audit log events.

## POST /api/v1/exports

Create a new CSV export with optional filters. Exports are processed in the background.

### Request Body

<ParamField body="from" type="string">
  ISO 8601 timestamp. Export events from this time onward.
</ParamField>

<ParamField body="to" type="string">
  ISO 8601 timestamp. Export events up to this time.
</ParamField>

<ParamField body="actor_id" type="string">
  Filter exported events by actor identifier.
</ParamField>

<ParamField body="action" type="string">
  Filter by action.
</ParamField>

<ParamField body="resource" type="string">
  Filter by resource type.
</ParamField>

<ParamField body="tenant_id" type="string">
  Filter by tenant identifier.
</ParamField>

<ParamField body="session_id" type="string">
  Filter by session identifier.
</ParamField>

<ParamField body="search" type="string">
  Case-insensitive search across event fields.
</ParamField>

### Response

Returns `202 Accepted`:

```json theme={null}
{
  "data": {
    "id": "exp_9c2f4a7b-1d3e-4f5a-8b6c-7d8e9f0a1b2c",
    "status": "pending"
  }
}
```

### Examples

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

  ```typescript JavaScript theme={null}
  const exp = await client.createExport({
    actor_id: "user_2hG9kLm",
    from: "2026-03-01T00:00:00Z",
    to: "2026-03-31T23:59:59Z",
  });
  ```

  ```php Laravel theme={null}
  $export = AuditLog::createExport([
      'actor_id' => 'user_2hG9kLm',
      'from' => '2026-03-01T00:00:00Z',
      'to' => '2026-03-31T23:59:59Z',
  ]);
  ```
</CodeGroup>

### Limits

* Maximum **5 concurrent exports** per workspace.
* Each export counts toward your monthly export quota.

<Warning>
  Events outside your [retention window](/platform/retention) are not included in exports.
</Warning>