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
{
"success": false,
"result": {
"code": "validation_failed"
},
"message": "format must be csv."
}
Malware
Export Malware Scans
Download your past malware scans as a CSV file. Free.
GET
/
api
/
lookup
/
malware
/
scans
/
export
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
{
"success": false,
"result": {
"code": "validation_failed"
},
"message": "format must be csv."
}
Export Malware Scans returns your scans as one CSV file, newest first, with the same filters as List Malware Scans. Exporting is free.
A cell that would start a spreadsheet formula is prefixed with an apostrophe, so
opening the file in a spreadsheet never runs it.
Authentication
Send your API key asAuthorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
Request
An export holds at most 10,000 rows. To export more, narrowfrom and to.
Example request
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:
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. |
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. |
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. |
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
{
"success": false,
"result": {
"code": "validation_failed"
},
"message": "format must be csv."
}
Was this page helpful?