Skip to main content
POST
/
scans
/
cve
/
scan
/
multiple-ips
Start On-Demand Multi-IP Scan
curl --request POST \
  --url https://api.altostrat.io/scans/cve/scan/multiple-ips \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "schedule_id": "9c43cc95-f313-49a3-b632-524f7a24503b",
  "site_id": "9c3c1392-7f36-4240-85f2-273573c0384a",
  "ips": [
    "192.168.1.55",
    "192.168.1.60"
  ]
}'
{
  "scan_id": "9c46a6f1-a8d8-4f5a-9b2f-7d1b3e9c5a1d",
  "scan_site_id": "9c46a6f1-b9e9-4f5a-9b2f-8e2c4f0d6b2e",
  "target_ips": [
    "192.168.1.55",
    "192.168.1.60"
  ],
  "message": "Scan started successfully"
}

Authorizations

โ€‹
Authorization
string
header
required

Enter your bearer token in the format: Bearer {token}

Body

application/json

Details of the scan to initiate.

โ€‹
schedule_id
string<uuid>
required

The ID of the schedule whose configuration will be used for the scan.

Example:

"9c43cc95-f313-49a3-b632-524f7a24503b"

โ€‹
site_id
string<uuid>
required

The ID of the site where the target IP addresses are located.

Example:

"9c3c1392-7f36-4240-85f2-273573c0384a"

โ€‹
ips
string<ipv4>[]
required

A list of specific IPv4 addresses to scan.

Example:
["192.168.1.55", "192.168.1.60"]

Response

The multi-IP scan has been created and queued for execution.

โ€‹
scan_id
string<uuid>

The unique identifier for the newly created parent scan object.

Example:

"9c46a6f1-a8d8-4f5a-9b2f-7d1b3e9c5a1d"

โ€‹
scan_site_id
string<uuid>

The unique identifier for this specific site scan instance.

Example:

"9c46a6f1-b9e9-4f5a-9b2f-8e2c4f0d6b2e"

โ€‹
target_ips
string<ipv4>[]
Example:
["192.168.1.55", "192.168.1.60"]
โ€‹
message
string
Example:

"Scan started successfully"