Retrieve Scan Status

[GET] /qps/rest/3.0/status/was/wasscan/<id>

Retrieve the status of a scan on a web application which is in the user’s scope.

Permissions required: User must have WAS module enabled. User account must have these permissions: Access Permission API Access. The output includes scan targets in the user's scope.

Input ParametersInput Parameters

The element “id” (integer) is required, where “id” identifies the scan.

Click here for available operators

Sample - View scan status along with authentication statusSample - View scan status along with authentication status

View details for the scan with the ID 1902350.

API request:

curl -n -u "USERNAME:PASSWORD" "<qualys_base_url>/qps/rest/3.0/status/was/wasscan/1902350"

XML response:

<?xml version="1.0" encoding="UTF-8"?>
<ServiceResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="<qualys_base_url>/qps/xsd/3.0/was/wasscan.xsd">
    <responseCode>SUCCESS</responseCode>
    <count>1</count>
    <data>
        <WasScan>
            <id>1902350</id>
            <status>FINISHED</status>
            <summary>
                <resultsStatus>NO_HOST_ALIVE</resultsStatus>
                <authStatus>NONE</authStatus>
            </summary>
        </WasScan>
    </data>
</ServiceResponse>

XSD

<platform API server>/qps/xsd/3.0/was/scan.xsd