Get PCI Share Status

GET POST/api/2.0/fo/scan/pci/?action=status

Get the share status of a PCI scan that has been already shared with PCI merchant account.

Input ParametersInput Parameters

Parameter

Required/Optional

Data Type

Description

action=status

Required

String 

Specify action to get PCI scan share status

echo_request={0|1}

Optional

Integer 

Specify 1 to view (echo) input parameters in the XML output. By default these are not included.

scan_ref={value}

Required

Integer 

The scan reference of the shared scan that you want to check the share status for.

Sample - Get PCI Scan Share StatusSample - Get PCI Scan Share Status

API Request

curl -s -H "X-Requested-With: curl demo 2" -u "USERNAME:PASSWORD" -d "action=status&scan_ref=scan/1531755831.21639&merchant_username=asmith@hq" "https://<qualys_base_url>/api/2.0/fo/scan/pci/"

XML Output

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE PCI_SCAN_SHARE_STATUS SYSTEM "https://<qualys_base_url>/api/2.0/fo/scan/pci/pci_scan_share_status.dtd">
<PCI_SCAN_SHARE_STATUS>
 <RESPONSE>
   <SCAN>
     <MERCHANT_USERNAME>asmith@hq</MERCHANT_USERNAME>
     <SCAN_REF>scan/1531755831.21639</SCAN_REF>
     <STATUS>In Progress</STATUS>
     <LAST_SHARED>2018-07-19T05:05:58Z</LAST_SHARED>
   </SCAN>
 </RESPONSE>
</PCI_SCAN_SHARE_STATUS>

DTD

<platform API server>/api/2.0/fo/scan/pci/pci_scan_share_status.dtd