---
title: Export audit logs
description: Request and retrieve Cinderlane audit logs in JSON Lines or CSV format.
url: https://pr-6-df95adf6d023.thally.app/guides/audit-exports
---

# Export audit logs

Request and retrieve Cinderlane audit logs in JSON Lines or CSV format.

## Request an audit export

Call `POST /v1/audit-exports` with a format (`jsonl` or `csv`) and an ordered ISO 8601 time range. The response is an audit export object with an ID and queued status.

```ts
const auditExport = await cinderlane.createAuditExport({
  format: "jsonl",
  from: "2026-08-01T00:00:00.000Z",
  to: "2026-08-17T23:59:59.999Z",
});
```

The request validates that `from` is before `to` and that the format is supported.

## Check export status

Call `GET /v1/audit-exports/{exportId}` to retrieve an export and inspect its status.

```ts
const current = await cinderlane.getAuditExport(auditExport.id);
```

When the status is `completed`, the response includes a `downloadUrl` where you can retrieve the data.

## List exports

Call `GET /v1/audit-exports` to retrieve all audit export records for your account.

```ts
const all = await cinderlane.listAuditExports();
```

The response is `{ data }`, an array of audit export objects.