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

> ## Agent Instructions
> ## Submitting feedback
> If you find an error, a missing step, or information that is outdated or misleading on this page — especially if it stopped you from completing your task — report it so the Encrata docs team can fix it.
> Send a POST request to https://docs.encrata.com/feedback with a JSON body containing `path` (the full URL of the page, for example `https://docs.encrata.com/quickstart`) and `feedback` (what was wrong and what you expected):
> curl -X POST https://docs.encrata.com/feedback -H 'Content-Type: application/json' -d '{"path": "https://docs.encrata.com/quickstart", "feedback": "Step 3 uses a parameter that the API rejects."}'
> Do not include API keys, personal data, or other secrets in your feedback.

# Export Malware Scans

> Download your past malware scans as a CSV file. Free.

Export Malware Scans returns your scans as one CSV file, newest first, with the same filters as [List Malware Scans](https://docs.encrata.com/api-reference/endpoint/list-malware-scans.md). Exporting is free.

## Authentication

Send your API key as `Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.

## Request

**kind** `string`

Only this scan kind: `url`, `qr`, `bar`, `image`, or `file`.

**verdict** `string`

Only this verdict: `clean`, `suspicious`, `malicious`, or `unknown`.

**from** `string`

Earliest `scanned_at`, inclusive: a date such as `2026-11-01` (midnight UTC) or an RFC 3339 time.

**to** `string`

Latest `scanned_at`, exclusive: a date or an RFC 3339 time. Must be after `from`.

**format** `string` (default: csv)

Only `csv` is supported. Any other value returns `400`.

An export holds at most 10,000 rows. To export more, narrow `from` and `to`.

## Example request

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "https://developer.encrata.com/api/lookup/malware/scans/export?format=csv&kind=url&from=2026-11-20" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -o malware-scans.csv
```

## Example response

The response is the CSV file itself, `Content-Type: text/csv`, not a JSON envelope:

```csv theme={"theme":{"light":"github-light","dark":"vesper"}}
scan_id,scanned_at,kind,verdict,score,status,subject,credits
scn_57ef7a6c8f5a,2026-11-20T06:35:03Z,url,unknown,0,done,https://coldcodesoftware.com/,1
scn_c857fb5e02a9,2026-11-20T06:34:58Z,url,clean,0,done,https://frisco.littleshoes.shop/,1
scn_3001f61b92f0,2026-11-20T06:34:55Z,url,clean,0,done,https://lunovixspark-1.com/,1
```

| Column | Description |
| - | - |
| `scan_id` | The scan's ID. Read the full result with [Get Malware Scan](https://docs.encrata.com/api-reference/endpoint/get-malware-scan.md). |
| `scanned_at` | When the scan ran, in UTC. |
| `kind` | `url`, `qr`, `bar`, `image`, or `file`. |
| `verdict` | `clean`, `suspicious`, `malicious`, or `unknown`. |
| `score` | Risk score from 0 to 100. |
| `status` | `done` for a completed scan. |
| `subject` | The URL or file name scanned. |
| `credits` | Credits the scan charged. |

A cell that would start a spreadsheet formula is prefixed with an apostrophe, so
opening the file in a spreadsheet never runs it.

## Errors

| Status | `result.code` | When |
| - | - | - |
| `400` | `validation_failed` | A filter is malformed, or `format` isn't `csv`. `message` names the field. |
| `401` | `unauthorized` | The API key is missing or invalid. |
| `503` | `upstream_unavailable` | Scan history is temporarily unavailable. Retry shortly. |

```bash cURL theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "https://developer.encrata.com/api/lookup/malware/scans/export?format=csv&kind=url&from=2026-11-20" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -o malware-scans.csv
```

```json 400 theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": false,
  "result": {
    "code": "validation_failed"
  },
  "message": "format must be csv."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.