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

# Export jobs as CSV or JSONL

> Export jobs as CSV or JSONL for compliance / migration. Streams up to 10k rows per call…

Export jobs as CSV or JSONL for compliance / migration.

Streams up to 10k rows per call. For larger volumes, paginate via
`since`/`until` windows and stitch on the client side. CSV is RFC
4180-compliant (quoted fields, `\r\n` line endings); JSONL is
one JSON object per line.

Columns / fields: `id`, `template`, `status`, `summary`, `error`,
`input_tokens`, `output_tokens`, `cost_usd`, `created_at`,
`updated_at`, `tags` (semicolon-joined in CSV).

### Query parameters

<ParamField query="format" type="string">
  Output format. `csv` (default) or `jsonl`.
</ParamField>

<ParamField query="status" type="string,null">
  Filter to a single status; mirrors `/jobs?status=`.
</ParamField>

<ParamField query="template" type="string,null">
  Filter to a single agent\_type.
</ParamField>

<ParamField query="since" type="string,null">
  ISO 8601 lower bound on `created_at`; rows older are excluded.
</ParamField>

<ParamField query="until" type="string,null">
  ISO 8601 upper bound on `created_at`; rows newer are excluded.
</ParamField>

<ParamField query="limit" type="integer">
  Hard cap on rows returned. Max 10000.
</ParamField>

### Response

Returns `text/csv` — Streamed export, sent as an attachment (`Content-Disposition`). `text/csv` by default; `application/x-ndjson` with `format=jsonl`. Up to 10,000 rows per call — window larger volumes with `since`/`until`.

### Status codes

| Code  | Meaning                                                                                                                                                                                                     |
| ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200` | Streamed export, sent as an attachment (`Content-Disposition`). `text/csv` by default; `application/x-ndjson` with `format=jsonl`. Up to 10,000 rows per call — window larger volumes with `since`/`until`. |
| `422` | Validation Error                                                                                                                                                                                            |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.computer.stateset.app/api/v1/jobs/export' \
    --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  "id,template,status,summary,error,input_tokens,output_tokens,cost_usd,created_at,updated_at,tags\r\n3fa85f64-5717-4562-b3fc-2c963f66afa6,shopify,completed,Order lookup finished,,1250,310,0.0421,2026-08-30T12:00:00Z,2026-08-30T12:04:10Z,daily;orders"
  ```
</ResponseExample>