Scan Management

/AppSpiderEnterprise/rest/v1/Scan/GetScans Description Retrieves the scans list for the client

Parameters No parameters

Response Messages

Response status codeReasonDescription
200Response contains the list of scans

Response example:

{ "type":"object", "properties": { "Scans": { "type":"array", "items": { "type":"object", "properties": { "Id": { "type":"string", "required": true }, "EngineGroupId": { "type":["string", "null"], "required": true }, "EngineId": { "type":["string", "null"], "required": true }, "Token": { "type":["string", "null"], "required": true }, "Status": { "type":"integer", "required": true }, "StartTime": { "type":["string", "null"], "required": true }, "WindowsScanStart": { "type":["string", "null"], "required": true }, "WindowScanStop": { "type":["string", "null"], "required": true }, "StopTime": { "type":["string", "null"], "required": true }, "CompletionTime": { "type":["string", "null"], "required": true }, "StartedBy": { "type":["string", "null"], "required": true }, "ConfigId": { "type":["string", "null"], "required": true }, "IsApproveRequired": { "type":"boolean", "required": true }, "IsMonitoring": { "type":"boolean", "required": true }, "IsUploaded": { "type":"boolean", "required": true }, "IsImported": { "type":"boolean", "required": true }, "Targets": { "type":"array", "items": { "type":"object", "properties": { "Id": { "type":"string", "required": true }, "Host": { "type":"string", "required": true }, } } } }, "additionalProperties": false } }, "IsSuccess": { "type":"boolean" "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/GetScans Description Retrieves the list of scans for the client by the config id

Parameters

ParametersTypeRequiredDescription
configIdguid[]YThe config id

Response Messages

Response status codeReasonDescription
200Response contains the list of scans
400Config Id does not exist in client

Response example:

{ "type":"object", "properties": { "Scans": { "type":"array", "items": { "type":"object", "properties": { "Id": { "type":"string", "required": true }, "EngineGroupId": { "type":["string", "null"], "required": true }, "EngineId": { "type":["string", "null"], "required": true }, "Token": { "type":["string", "null"], "required": true }, "Status": { "type":"integer", "required": true }, "StartTime": { "type":["string", "null"], "required": true }, "WindowsScanStart": { "type":["string", "null"], "required": true }, "WindowScanStop": { "type":["string", "null"], "required": true }, "StopTime": { "type":["string", "null"], "required": true }, "CompletionTime": { "type":["string", "null"], "required": true }, "StartedBy": { "type":["string", "null"], "required": true }, "ConfigId": { "type":["string", "null"], "required": true }, "IsApproveRequired": { "type":"boolean", "required": true }, "IsMonitoring": { "type":"boolean", "required": true }, "IsUploaded": { "type":"boolean", "required": true }, "IsImported": { "type":"boolean", "required": true }, "Targets": { "type":"array", "items": { "type":"object", "properties": { "Id": { "type":"string", "required": true }, "Host": { "type":"string", "required": true }, } } } }, "additionalProperties": false } }, "IsSuccess": { "type":"boolean" "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/GetScans Description Retrieves the list of scans for the client by the config id with paging

Parameters

ParametersTypeRequiredDescription
configIdguid[]YThe config id
pageintYThe page of results to return (page starts at 0)
pageSizeintYThe number of results to return per page

Response Messages

Response status codeReasonDescription
200Response contains the list of scans
400Config Id does not exist in client

Response example:

{ "type":"object", "properties": { "Scans": { "type":"array", "items": { "type":"object", "properties": { "Id": { "type":"string", "required": true }, "EngineGroupId": { "type":["string", "null"], "required": true }, "EngineId": { "type":["string", "null"], "required": true }, "Token": { "type":["string", "null"], "required": true }, "Status": { "type":"integer", "required": true }, "StartTime": { "type":["string", "null"], "required": true }, "WindowsScanStart": { "type":["string", "null"], "required": true }, "WindowScanStop": { "type":["string", "null"], "required": true }, "StopTime": { "type":["string", "null"], "required": true }, "CompletionTime": { "type":["string", "null"], "required": true }, "StartedBy": { "type":["string", "null"], "required": true }, "ConfigId": { "type":["string", "null"], "required": true }, "IsApproveRequired": { "type":"boolean", "required": true }, "IsMonitoring": { "type":"boolean", "required": true }, "IsUploaded": { "type":"boolean", "required": true }, "IsImported": { "type":"boolean", "required": true }, "Targets": { "type":"array", "items": { "type":"object", "properties": { "Id": { "type":"string", "required": true }, "Host": { "type":"string", "required": true }, } } } }, "additionalProperties": false } }, "IsSuccess": { "type":"boolean" "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true }, "TotalCount": { "type": "integer", "required": true }, "TotalPages": { "type": "integer", "required": true }, "Links": { "type": "array", "items": { "Rel": { "type":["string", "null"], "required": true }, "Href": { "type":["string", "null"], "required": true } } } }, }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/RunScan Description Start a scan

⚠️

Attention

At least one parameter should be provided to start a scan

Parameters

NameTypeRequiredDescription
configIdguid[]NScan config ID
configNamestringNScan config name

RunScan config

All though neither the ‘configId’ nor the ‘configName’ is required at least one of them must be configured for the request to be successful.

Response Messages

Response status codeReasonDescription
200Scan config removed
400InvalidJsonSchemaRequired parameters not provided
400ScanStartFailedScan config with ‘configId’ doesn’t exist in client. Scan config with ‘configName’ not found in client. Scan config targets are not approved for user.

/AppSpiderEnterprise/rest/v1/Scan/CancelScan Description Cancels “Starting” or “Waiting for Cloud” scan

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Scan was canceled
400InvalidJsonSchemaRequired parameters not provided

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/PauseScan Description Pauses a running scan

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Scan was paused
400InvalidJsonSchemaRequired parameters not provided

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/ResumeScan Description Resumes a paused scan

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Scan was resumed
400InvalidJsonSchemaRequired parameters not provided

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/StopScan Description Stop a running scan

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Scan was stopped
400InvalidJsonSchemaRequired parameters not provided

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/PauseAllScans Description Pauses all running scans for the client

Parameters No parameters

Response Messages

Response status codeReasonDescription
200Scans were paused

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/ResumeAllScans Description Resumes all paused scans for the client

Parameters No parameters

Response Messages

Response status codeReasonDescription
200Scans were resumed

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/StopAllScans Description Stops all scans for the client

Parameters No parameters

Response Messages

Response status codeReasonDescription
200Scans were stopped

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/CancelAllScans Description Cancels all “Starting” and “Waiting for cloud” scans for the client

Parameters No parameters

Response Messages

Response status codeReasonDescription
200Scans were all canceled

Response example:

{ "type":"object", "properties": { "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/GetScanStatus Description Retrieves the scan status represented by a string

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Response contains scan status
400InvalidJsonSchemaRequired parameters not provided
400ScanNotFoundScan not found

Response example:

Returned Statuses (case-sensitive): ● “Starting” - scan is starting ● “Starting..” - internal status using for starting scan ● “Running” - scan is running ● “Running..” - internal status using for running scan ● “Running…” - internal status using for running scan ● “Waiting for Cloud” - scan is waiting for cloud scan engine ● “Stopping” - scan is stopping ● “Stopping..” - internal status using for stopping scan ● “Stopping…” - internal status using for stopping scan ● “Waiting for Stopped” - internal status using for stopping scan ● “Waiting for Stopped..” - internal status using for stopping scan ● “Waiting for Stopped…” - internal status using for stopping scan ● “Pausing” - scan is pausing ● “Pausing..” - internal status using for pausing scan ● “Pausing…” - internal status using for pausing scan ● “Resuming” - scan is resuming after pause ● “Resuming..” - internal status using for resuming scan ● “Resuming…” - internal status using for resuming scan ● “Canceling” - scan is canceling ● “Canceling..” - internal status using for canceling scan ● “Canceling…” - internal status using for canceling scan ● “Stopped” - scan is stopped ● “Paused” - scan is paused ● “Pending Blackout” - internal status using for blackouted scan ● “Blackouted” - scan is paused by blackout ● “Pending Upload” - internal status using for uploading scan ● “Hanged” - scan is hanged ● “Failed” - scan is failed ● “Vuln Load Failed” - vulnerabilities load from scan report failed ● “Completed” - scan is completed ● “Starting Upload - internal status using for uploading scan ● “Starting Upload..” - internal status using for uploading scan ● “Starting Update” - internal status using for updating scan ● “Deleting All” - scan deleting is in progress ● “Download failed” - scan report download is failed

{ "type":"object", "properties": { "Status": { "type":["string", "null"], "required": true }, "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/IsScanActive Description Checks to see if the specified scan is active

Parameters

NameTypeRequiredDescription
scanIdguid[]YScanID

Response Messages

Response status codeReasonDescription
200Response contains boolean value
400InvalidJsonSchemaRequired parameters not provided
400ScanNotFoundScan not found

Response example:

{ "type":"object", "properties": { "Result": { "type":"boolean", "required": true }, "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/IsScanFinished Description Checks to see if the specified scan was completed

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Response contains boolean value
400InvalidJsonSchemaRequired parameters not provided
400ScanNotFoundScan not found

Response example:

{ "type":"object", "properties": { "Result": { "type":"boolean", "required": true }, "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/HasReport Description Checks to see if the specified scan has a report

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Response contains boolean value
400InvalidJsonSchemaRequired parameters not provided
400ScanNotFoundScan not found

Response example:

{ "type":"object", "properties": { "Result": { "type":"boolean", "required": true }, "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }

/AppSpiderEnterprise/rest/v1/Scan/GetScanErrors Description Gets scan error log

Parameters

NameTypeRequiredDescription
scanIdguid[]YScan ID

Response Messages

Response status codeReasonDescription
200Response contains boolean value
400InvalidJsonSchemaRequired parameters not provided
400ScanNotFoundScan not found
400ScanIsNotAllowedUser does not have permissions to access scan

Response example:

{ "type":"object", "properties": { "Events": { "type":"array", "properties": { "Type": { "type":"string", "required": true }, "Date": { "type":["string", "null"], "required": true }, "Message": { "type":["string", "null"], "required": true } }, "additionalProperties": false } }, "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": flase }

/AppSpiderEnterprise/rest/v1/Scan/GetScanStatuses Description Retrieves the list of possible statuses for a scan

Parameters No Parameters

Response Messages

Response status codeReasonDescription
200Response contains the list of scan status types

Response example:

Returned list of Statuses for a scan (case-sensitive) ● “Starting” - scan is starting ● “PendingStarting” - internal status used for starting scan ● “ValidatingStarting” - internal status used for starting scan ● “Running” - scan is running ● “ValidateRunning” - internal status used for running scan ● “ValidatingRunning” - internal status used for running scan ● “StartingCloud” - scan is waiting for cloud scan engine ● “Stopping” - scan is stopping ● “PendingStopping” - internal status used for stopping scan ● “ValidatingStopping” - internal status using for stopping scan ● “ActStopped” - internal status using for stopping scan ● “ValidateStopped” - internal status using for stopping scan ● “ValidatingStopped” - internal status using for stopping scan ● “Pausing” - scan is pausing ● “PendingPausing” - internal status used for pausing scan ● “ValidatingPausing” - internal status used for pausing scan ● “Resuming” - scan is resuming after pause ● “PendingResuming” - internal status used for resuming scan ● “ValidatingResuming” - internal status used for resuming scan ● “Canceling” - scan is canceling ● “PendingCanceling” - internal status used for canceling scan ● “ValidatingCanceling” - internal status used for canceling scan ● “Stopped” - scan is stopped ● “Paused” - scan is paused ● “PendingPauseByBlackout” - internal status used for blackouted scan ● “PausedByBlackout” - scan is paused by blackout ● “PendingUpload” - internal status used for uploading scan ● “Hanged” - scan is hanged ● “Failed” - scan is failed ● “VulnLoadFailed” - vulnerabilities load from scan report failed ● “Completed” - scan is completed ● “StartUpload” - internal status used for uploading scan ● “PendingStartUpload” - internal status used for uploading scan ● “ValidatingStartUpload” - internal status used for uploading scan ● “StartUpdate” - internal status used for updating scan ● “StartDeleteWithReports” - scan deleting is in progress ● “ReportError” - scan report download is failed ● “ReportRegenerating” - report regenerating started ● “ReportRegeneratingOnCloud” - report regenerating on Cloud ●“ReportRegeneratingRunning” - report regenerating ● “ReportRegeneratingError” - report regeneration failed ● “ReportRegeneratingCompleted” - report regeneration completed /AppSpiderEnterprise/rest/v1/Scan/HasScanImported Description Retrieves the scan status and import flag representing whether vulnerabilities have been imported from the completed scan

Parameters

NameTypeRequiredDescription
scanIdguid[]YThe scan ID

Response Messages

Response status codeReasonDescription
200Response contains scan status and import flag
400ScanNotFoundScan not found
{ "type":"object", "properties": { "IsImported": { "type":"boolean", "required": true }, "Status": { "type":["string", "null"], "required": true }, "IsSuccess": { "type":"boolean", "required": true }, "ErrorMessage": { "type":["string", "null"], "required": true }, "Reason": { "type":["string", "null"], "required": true } }, "additionalProperties": false }