curl "https://developer.encrata.com/api/lookup/malware/scans?kind=url&limit=2" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"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."
}
{
"success": false,
"result": {
"code": "validation_failed"
},
"message": "verdict must be one of: clean, suspicious, malicious, unknown."
}
Malware
List Malware Scans
List your past malware scans, newest first, with filters. Free.
GET
/
api
/
lookup
/
malware
/
scans
curl "https://developer.encrata.com/api/lookup/malware/scans?kind=url&limit=2" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"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."
}
{
"success": false,
"result": {
"code": "validation_failed"
},
"message": "verdict must be one of: clean, suspicious, malicious, unknown."
}
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. Listing is free.
Authentication
Send your API key asAuthorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
Request
Example request
curl "https://developer.encrata.com/api/lookup/malware/scans?kind=url&limit=2" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Example response
{
"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
One summary per scan:
scan_id, kind, verdict, score, status,
subject (the URL or file name scanned), credits, and scanned_at.Page through every scan
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. |
curl "https://developer.encrata.com/api/lookup/malware/scans?kind=url&limit=2" \
-H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"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."
}
{
"success": false,
"result": {
"code": "validation_failed"
},
"message": "verdict must be one of: clean, suspicious, malicious, unknown."
}
Was this page helpful?