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

# Get Malware Scan

> Read a past malware scan by its scan_id. Free.

Get Malware Scan returns a scan you already ran, by the `scan_id` in its response. Use it to show a result again, attach it to a ticket, or check what a webhook reported. Reading a scan is free and never scans again.

## Authentication

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

## Request

**scan\_id** `string` *required*

The `scan_id` from the scan response or the `scan.completed` webhook, such as `scn_aa8415cbf35f`.

**stix** `boolean` (default: false)

Set to `true` to attach a STIX 2.1 bundle of the findings as `result.stix`.

You can read only your own scans in the current workspace. An unknown ID, a
malformed ID, and another workspace's scan all return `404`.

## Example request

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

## Example response

The response has the same shape as the scan that produced it. This one is shortened; see
[URL Scan](https://docs.encrata.com/api-reference/endpoint/url-scan.md#example-response) for every field.

```json theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": true,
  "result": {
    "scan_id": "scn_aa8415cbf35f",
    "kind": "url",
    "status": "done",
    "verdict": "clean",
    "score": 10,
    "credits": 1,
    "submitted_url": "https://example.com/?enc2815webhook=1795153850",
    "final_url": "https://example.com/?enc2815webhook=1795153850",
    "category": "benign",
    "confidence": "medium",
    "coverage": "complete",
    "assessment": "No threats detected by the checks completed. This is not a guarantee of safety.",
    "recommended_action": "allow_with_policy",
    "signals": [
      {
        "source": "malware_url_feed",
        "malicious": false,
        "detail": "This exact link is not listed, but other links on the same site have been reported for malware or phishing.",
        "severity": "low"
      }
    ],
    "iocs": [
      {
        "type": "domain",
        "value": "example.com",
        "role": "observed"
      },
      {
        "type": "url",
        "value": "https://example.com/?enc2815webhook=1795153850",
        "role": "observed"
      },
      {
        "type": "ip",
        "value": "104.20.23.154",
        "source": "hosting",
        "role": "observed"
      }
    ],
    "scanned_at": "2026-11-20T05:50:50.998753866Z"
  },
  "message": "Scan loaded."
}
```

`result.credits` is what the original scan cost. Reading it again costs nothing.

> [!NOTE]
>
> Scans run before this endpoint existed return summary fields only: `verdict`,
> `score`, `status`, `signals`, `iocs`, and the URL fields.

## Errors

| Status | `result.code` | When |
| - | - | - |
| `400` | `validation_failed` | `stix` isn't `true` or `false`. |
| `401` | `unauthorized` | The API key is missing or invalid. |
| `404` | `not_found` | No scan with this ID for you in this workspace. |
| `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/scn_aa8415cbf35f" \
  -H "Authorization: Bearer enc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

```json 200 theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": true,
  "result": {
    "scan_id": "scn_aa8415cbf35f",
    "kind": "url",
    "status": "done",
    "verdict": "clean",
    "score": 10,
    "credits": 1,
    "submitted_url": "https://example.com/?enc2815webhook=1795153850",
    "final_url": "https://example.com/?enc2815webhook=1795153850",
    "final_domain": "example.com",
    "redirects": [
      "https://example.com/?enc2815webhook=1795153850"
    ],
    "reachable": true,
    "category": "benign",
    "confidence": "medium",
    "redirect_hops": [
      {
        "url": "https://example.com/?enc2815webhook=1795153850",
        "status_code": 200,
        "host": "example.com"
      }
    ],
    "domain": {
      "name": "example.com",
      "registrar": "RESERVED-Internet Assigned Numbers Authority",
      "created_at": "1995-08-14",
      "updated_at": "2026-08-14",
      "expires_at": "2027-08-13",
      "age_days": 11421,
      "status": [
        "client delete prohibited",
        "client transfer prohibited",
        "client update prohibited"
      ],
      "nameservers": [
        "elliott.ns.cloudflare.com",
        "hera.ns.cloudflare.com"
      ],
      "dnssec": "signed",
      "tld": "com",
      "risky_tld": false
    },
    "tls": {
      "version": "TLS 1.3",
      "cipher_suite": "TLS_AES_128_GCM_SHA256",
      "trusted": true,
      "self_signed": false,
      "expired": false,
      "issuer": "Cloudflare TLS Issuing ECC CA 3",
      "issuer_org": "SSL Corporation",
      "subject": "example.com",
      "sans": [
        "example.com",
        "*.example.com"
      ],
      "not_before": "2026-09-26T22:49:11Z",
      "not_after": "2026-12-25T22:56:35Z",
      "days_remaining": 35,
      "cert_age_days": 54,
      "fingerprint_sha256": "85ca6ab068e9bcce88b6c4aa3c47f7d17228134a457f870d3800e6223a0df07a",
      "serial": "1EEE6AABB521D5E14FC315FD9985690"
    },
    "hosting": {
      "ip": "104.20.23.154",
      "asn": 13335,
      "as_name": "Cloudflare, Inc.",
      "org": "Cloudflare, Inc.",
      "country": "Canada",
      "country_code": "CA",
      "in_eu": false,
      "network_cidr": "104.16.0.0/12",
      "rir": "ARIN",
      "abuse_contact": "abuse@cloudflare.com",
      "cloud_provider": "Cloudflare",
      "is_hosting": true,
      "is_vpn": false,
      "is_proxy": false,
      "is_tor": false,
      "blocklisted": false
    },
    "page": {
      "status_code": 200,
      "content_type": "text/html; charset=utf-8",
      "server": "cloudflare",
      "title": "Example Domain",
      "size_bytes": 577,
      "password_fields": 0,
      "forms": 0,
      "iframes": 0,
      "hidden_iframes": 0,
      "external_scripts": 0,
      "obfuscated_js": false,
      "security_headers": {
        "hsts": false,
        "csp": false,
        "x_frame_options": false
      }
    },
    "threat_intel": [
      {
        "source": "encrata intelligence",
        "status": "listed",
        "malicious": false,
        "first_seen": "2023-03-28T11:35:11Z",
        "detail": "This exact link is not listed, but other links on the same site have been reported for malware or phishing."
      },
      {
        "source": "encrata intelligence",
        "status": "not_listed",
        "malicious": false
      },
      {
        "source": "encrata intelligence",
        "status": "not_listed",
        "malicious": false
      },
      {
        "source": "encrata intelligence",
        "status": "not_listed",
        "malicious": false
      }
    ],
    "data_residency": "global",
    "checks": [
      {
        "name": "url_structure",
        "status": "ok"
      },
      {
        "name": "fetch",
        "status": "ok",
        "data_shared": "url",
        "jurisdictions": [
          "target"
        ]
      },
      {
        "name": "tls",
        "status": "ok"
      },
      {
        "name": "page_content",
        "status": "ok"
      },
      {
        "name": "reputation_feeds",
        "status": "ok",
        "data_shared": "domain",
        "jurisdictions": [
          "CH"
        ]
      },
      {
        "name": "domain_registration",
        "status": "ok",
        "data_shared": "domain",
        "jurisdictions": [
          "registry"
        ]
      },
      {
        "name": "hosting",
        "status": "ok",
        "data_shared": "ip",
        "jurisdictions": [
          "CH",
          "NL",
          "multiple",
          "registry",
          "unverified"
        ]
      }
    ],
    "coverage": "complete",
    "confidence_reason": "Nothing was found by fetch, reputation feeds, domain registration and hosting. 3 reputation source(s) checked it and did not list it. A clean result shows only that no known threat was found.",
    "assessment": "No threats detected by the checks completed. This is not a guarantee of safety.",
    "recommended_action": "allow_with_policy",
    "data_flow": [
      {
        "role": "direct_fetch",
        "description": "Encrata scanner egress (contacts the scanned server)",
        "check": "fetch",
        "jurisdiction": "target",
        "data_shared": "url",
        "status": "consulted"
      },
      {
        "role": "malware_url_feed",
        "description": "Threat-intelligence feed: malware and phishing URLs",
        "check": "reputation_feeds",
        "jurisdiction": "CH",
        "data_shared": "domain",
        "status": "consulted"
      },
      {
        "role": "ioc_feed",
        "description": "Threat-intelligence feed: indicators of compromise",
        "check": "reputation_feeds",
        "jurisdiction": "CH",
        "data_shared": "domain",
        "status": "consulted"
      },
      {
        "role": "phishing_url_list",
        "description": "Community phishing-URL list (downloaded and matched locally)",
        "check": "reputation_feeds",
        "jurisdiction": "local",
        "status": "consulted"
      },
      {
        "role": "phishing_url_feed",
        "description": "Phishing-URL feed (downloaded and matched locally)",
        "check": "reputation_feeds",
        "jurisdiction": "local",
        "status": "consulted"
      },
      {
        "role": "domain_registry",
        "description": "Domain registration registry (RDAP)",
        "check": "domain_registration",
        "jurisdiction": "registry",
        "data_shared": "domain",
        "status": "consulted"
      },
      {
        "role": "ip_registry",
        "description": "Regional Internet Registry (RDAP)",
        "check": "hosting",
        "jurisdiction": "registry",
        "data_shared": "ip",
        "status": "consulted"
      },
      {
        "role": "reverse_dns",
        "description": "Local DNS resolver",
        "check": "hosting",
        "jurisdiction": "local",
        "data_shared": "ip",
        "status": "consulted"
      },
      {
        "role": "routing_registry",
        "description": "Internet routing registry",
        "check": "hosting",
        "jurisdiction": "NL",
        "data_shared": "ip",
        "status": "consulted"
      },
      {
        "role": "c2_feed",
        "description": "Threat-intelligence feed: command-and-control servers",
        "check": "hosting",
        "jurisdiction": "CH",
        "data_shared": "ip",
        "status": "consulted"
      },
      {
        "role": "ip_geolocation",
        "description": "IP geolocation service",
        "check": "hosting",
        "jurisdiction": "unverified",
        "data_shared": "ip",
        "status": "consulted"
      },
      {
        "role": "dns_blocklists",
        "description": "DNS blocklist operators",
        "check": "hosting",
        "jurisdiction": "multiple",
        "data_shared": "ip",
        "status": "consulted"
      }
    ],
    "duration_ms": 1609,
    "signals": [
      {
        "source": "malware_url_feed",
        "malicious": false,
        "detail": "This exact link is not listed, but other links on the same site have been reported for malware or phishing.",
        "severity": "low"
      }
    ],
    "iocs": [
      {
        "type": "domain",
        "value": "example.com",
        "role": "observed"
      },
      {
        "type": "url",
        "value": "https://example.com/?enc2815webhook=1795153850",
        "role": "observed"
      },
      {
        "type": "ip",
        "value": "104.20.23.154",
        "source": "hosting",
        "role": "observed"
      }
    ],
    "scanned_at": "2026-11-20T05:50:50.998753866Z"
  },
  "message": "Scan loaded."
}
```

```json 404 theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": false,
  "result": {
    "code": "not_found"
  },
  "message": "We couldn't find a scan with that ID in this workspace. Check the scan_id from the scan response."
}
```

```json 401 theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "success": false,
  "result": {
    "code": "unauthorized",
    "reason": "invalid api key"
  },
  "message": "Please sign in to continue.",
  "request_id": "6f1c2a9e-4b7d-4e0a-9c3f-2d8b5e1a7c40"
}
```


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