Last reviewed February 25, 2026

API Endpoints

This page provides a comprehensive list of all available endpoints in the Sirius Scan REST API. The API follows REST principles and uses standard HTTP methods.

Base URL

All API requests should be made to:

http://localhost:9001

For production deployments, replace localhost:9001 with your Sirius Scan instance URL.

Scan Management

Start a new vulnerability scan for specified targets.

Request Body

{
  "id": "scan-123",
  "targets": [
    {
      "value": "192.168.123.188",
      "type": "single_ip"
    }
  ],
  "options": {
    "template": "quick"
  },
  "priority": 3
}

Parameters

FieldTypeDescription
idstringCustom identifier for the scan
targetsarrayList of targets to scan
targets[].valuestringTarget value (IP, hostname, etc.)
targets[].typestringType of target (single_ip, etc.)
options.templatestringScan template to use (quick, etc.)
prioritynumberScan priority level (1-5)

Example Request

curl -X POST "http://localhost:9001/app/scan" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "scan-123",
    "targets": [
        {
            "value": "192.168.123.188",
            "type": "single_ip"
        }
    ],
    "options": {
        "template": "quick"
    },
    "priority": 3
}'

Response

{
  "status": "Message sent successfully"
}

Host Management

Vulnerability Management

NVD Integration

Sirius Scan integrates with the National Vulnerability Database to enrich vulnerability data. The Go SDK's nvd package handles NVD lookups internally -- you do not need to query the NVD API directly.

Next Steps