Get results

Everything you need to know about retrieving scan results using the Houdin API

Retrieve results for a scan

Retrieve results for a scan

GET/api/v1/scan/result

Authorization

Houdin API Key

Query parameters

Response

200202400404

Success

Body

application/json

scanIDstring

Example: "houdin-a7675557-68ff-4a5a-9c3a-6de3d5bd8090"

statusstring

Example: "Done"

artifactstring

Example: "https://maliciousurl.com/infected.exe"

scanOnarray

scanResultsobject

scanTimestring

Example: "2023-01-01T00:00:00.000Z"

expiresAfterstring

Example: "2023-01-07T00:00:00.000Z"

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/scan/result?scanID=houdin-a7675557-68ff-4a5a-9c3a-6de3d5bd8090', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "scanID": "houdin-a7675557-68ff-4a5a-9c3a-6de3d5bd8090",
  "status": "Done",
  "artifact": "https://maliciousurl.com/infected.exe",
  "scanOn": [
    "vt",
    "urlscan",
    "alienvault",
    "abuseipdb"
  ],
  "scanResults": {},
  "scanTime": "2023-01-01T00:00:00.000Z",
  "expiresAfter": "2023-01-07T00:00:00.000Z"
}