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

# List Malware Scans

> List your past malware scans, newest first, with filters. Free.

List Malware Scans returns your scans in the current workspace, newest first, as summaries. Filter by kind, verdict, or date, then fetch any full result with [Get Malware Scan](https://docs.encrata.com/api-reference/endpoint/get-malware-scan.md). Listing 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`.

**limit** `integer` (default: 20)

Scans per page, from 1 to 100.

**cursor** `string`

`next_cursor` from the previous page, exactly as it was returned.

## Example request

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "https://developer.encrata.com/api/lookup/malware/scans?kind=url&limit=2" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

## Example response

```json theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": true,
  "result": {
    "items": [
      {
        "scan_id": "scn_c857fb5e02a9",
        "kind": "url",
        "verdict": "clean",
        "score": 0,
        "status": "done",
        "subject": "https://frisco.littleshoes.shop/",
        "credits": 1,
        "scanned_at": "2026-11-20T06:34:58Z"
      },
      {
        "scan_id": "scn_3001f61b92f0",
        "kind": "url",
        "verdict": "clean",
        "score": 0,
        "status": "done",
        "subject": "https://lunovixspark-1.com/",
        "credits": 1,
        "scanned_at": "2026-11-20T06:34:55Z"
      }
    ],
    "next_cursor": "eyJrIjoiMjAyNi0xMS0yMFQwNjozNDo1NVoiLCJpZCI6InNjbl8zMDAxZjYxYjkyZjAifQ"
  },
  "message": "Scans loaded."
}
```

## Response

**result.items** `object[]`

One summary per scan: `scan_id`, `kind`, `verdict`, `score`, `status`,
`subject` (the URL or file name scanned), `credits`, and `scanned_at`.

**result.next\_cursor** `string`

Pass it back as `cursor` to get the next page. Empty or absent on the last page.

## Page through every scan

```python theme={"theme":{"light":"github-light","dark":"vesper"}}
import requests

headers = {"Authorization": "Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}
params = {"verdict": "malicious", "from": "2026-11-01", "limit": 100}
while True:
    page = requests.get(
        "https://developer.encrata.com/api/lookup/malware/scans",
        headers=headers,
        params=params,
    ).json()["result"]
    for scan in page["items"]:
        print(scan["scan_id"], scan["verdict"], scan["subject"])
    if not page.get("next_cursor"):
        break
    params["cursor"] = page["next_cursor"]
```

## Errors

| Status | `result.code` | When |
| - | - | - |
| `400` | `validation_failed` | A filter, `limit`, or `cursor` is malformed. `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?kind=url&limit=2" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

```json 200 theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": true,
  "result": {
    "items": [
      {
        "scan_id": "scn_c857fb5e02a9",
        "kind": "url",
        "verdict": "clean",
        "score": 0,
        "status": "done",
        "subject": "https://frisco.littleshoes.shop/",
        "credits": 1,
        "scanned_at": "2026-11-20T06:34:58Z"
      },
      {
        "scan_id": "scn_3001f61b92f0",
        "kind": "url",
        "verdict": "clean",
        "score": 0,
        "status": "done",
        "subject": "https://lunovixspark-1.com/",
        "credits": 1,
        "scanned_at": "2026-11-20T06:34:55Z"
      }
    ],
    "next_cursor": "eyJrIjoiMjAyNi0xMS0yMFQwNjozNDo1NVoiLCJpZCI6InNjbl8zMDAxZjYxYjkyZjAifQ"
  },
  "message": "Scans loaded."
}
```

```json 400 theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": false,
  "result": {
    "code": "validation_failed"
  },
  "message": "verdict must be one of: clean, suspicious, malicious, unknown."
}
```


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