Skip to main content
GET
/
scans
/
cve
/
scheduled
/
{scanScheduleId}
Retrieve a Scan Schedule
curl --request GET \
  --url https://api.altostrat.io/scans/cve/scheduled/{scanScheduleId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "9c43cc95-f313-49a3-b632-524f7a24503b",
  "description": "Weekly Scan for Main Office",
  "day_of_week": 1,
  "time_of_day": "02:00",
  "every_n_weeks": 2,
  "timezone": "America/New_York",
  "min_cvss": 4,
  "warning_threshold": 7,
  "ignore_offline_sites": false,
  "next_scan_at": "2025-11-10T02:00:00-05:00",
  "running": false,
  "sites": [
    {
      "id": "9c3c1392-7f36-4240-85f2-273573c0384a",
      "subnet": "192.168.1.0/24"
    }
  ],
  "created_at": "2025-10-28T14:30:00Z",
  "updated_at": "2025-10-29T09:00:00Z",
  "status": "ready",
  "last_run_at": "2025-10-27T02:00:00-05:00",
  "notification_group": "security-alerts"
}

Authorizations

โ€‹
Authorization
string
header
required

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

Path Parameters

โ€‹
scanScheduleId
string<uuid>
required

The unique identifier of the scan schedule.

Example:

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

Response

The requested scan schedule object.

โ€‹
id
string<uuid>

The unique identifier for the scan schedule.

Example:

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

โ€‹
description
string

A human-readable name for the scan schedule.

Example:

"Weekly Scan for Main Office"

โ€‹
day_of_week
integer

The day of the week to run the scan (0=Sunday, 1=Monday, ..., 6=Saturday).

Example:

1

โ€‹
time_of_day
string

The time of day to run the scan in 24-hour format (HH:mm).

Example:

"02:00"

โ€‹
every_n_weeks
integer

The frequency of the scan in weeks (e.g., 2 for every 2 weeks).

Example:

2

โ€‹
timezone
string

The timezone in which the time_of_day is specified.

Example:

"America/New_York"

โ€‹
min_cvss
number

The minimum CVSS score for a vulnerability to be included in reports.

Example:

4

โ€‹
warning_threshold
number

The CVSS score at which a vulnerability is considered a high-priority warning.

Example:

7

โ€‹
ignore_offline_sites
boolean

If true, the scan will not fail if a site is offline.

Example:

false

โ€‹
next_scan_at
string<date-time>

The calculated timestamp for the next scheduled scan.

Example:

"2025-11-10T02:00:00-05:00"

โ€‹
running
boolean

Indicates if a scan for this schedule is currently in progress.

Example:

false

โ€‹
sites
object[]

A list of sites and their subnets to be scanned.

โ€‹
created_at
string<date-time>

The timestamp when the schedule was created.

Example:

"2025-10-28T14:30:00Z"

โ€‹
updated_at
string<date-time>

The timestamp when the schedule was last updated.

Example:

"2025-10-29T09:00:00Z"

โ€‹
status
string

The current status of the scan schedule's lifecycle.

Example:

"ready"

โ€‹
last_run_at
string<date-time>

The timestamp when a scan for this schedule was last initiated.

Example:

"2025-10-27T02:00:00-05:00"

โ€‹
notification_group
string

The identifier for a notification group to receive scan alerts.

Example:

"security-alerts"