List Tickets

/msp/ticket_list.php

View a list of selected tickets which the API user has permission to access.

Truncation - A maximum of 1,000 tickets can be returned from a single request. If this maximum is reached, the function returns a “Truncated after 1,000 records” message at the end of the XML output with the last ticket number included. Using an account with more than 1,000 tickets (or potentially more than 1,000 tickets), it is recommended that you write a script that makes multiple ticket_list.php requests until all tickets have been retrieved.

Permissions - Managers can view tickets for all IPs in the subscription, Unit Managers view tickets for all IPs in their own business unit, Scanners and Readers can view tickets for IPs in their own account.

Input ParametersInput Parameters

Click here to view ticket selection parameters. At least one ticket selection parameter must be specified.

The following additional parameter is available for ticket list.

Parameter	Required/Optional	Data Type	Description
show_vuln_details={0\|1}	Optional	Integer	Set to 1 to include vulnerability details (threat, impact, solution, results) in the ticket list. Vulnerability details are not included by default.

Sample - View Open Tickets for OwnerSample - View Open Tickets for Owner

API Request

https://<qualys_base_url>/msp/ticket_list.php? ticket_assignee=comp_ja&states=OPEN

Sample - View Ticket Number RangeSample - View Ticket Number Range

API Request

https://<qualys_base_url>/msp/ticket_list.php? ticket_numbers=001800-002800

Sample - List Tickets for Severity 5 VulnerabilitiesSample - List Tickets for Severity 5 Vulnerabilities

API Request

https://<qualys_base_url>/msp/ticket_list.php?vuln_severities=5

Sample - View Tickets That Have Been Marked as Closed/Fixed or Closed/Ignored Since June 1, 2018Sample - View Tickets That Have Been Marked as Closed/Fixed or Closed/Ignored Since June 1, 2018

API Request

https://<qualys_base_url>/msp/ticket_list.php?states=CLOSED,IGN ORED&modified_since_datetime=2018-06-01

Sample - List All Ignored VulnerabilitiesSample - List All Ignored Vulnerabilities

API Request

https://<qualys_base_url>/msp/ticket_list.php?asset_groups=All&states=IGNORED

Sample - View Tickets Related to SSH VulnerabilitiesSample - View Tickets Related to SSH Vulnerabilities

API Request

https://<qualys_base_url>/msp/ticket_list.php? vuln_title_contains=SSH&vuln_details_contains=SSH

Sample - View Invalid tickets for Hosts in the “Desktops” or “Servers” Asset GroupsSample - View Invalid tickets for Hosts in the “Desktops” or “Servers” Asset Groups

API Request

https://<qualys_base_url>/msp/ticket_list.php?asset_groups= Desktops,Servers&invalid=1

Sample - List All Tickets Filtered by Specific Host_id and Show_Host_idSample - List All Tickets Filtered by Specific Host_id and Show_Host_id

API Request

https://<qualys_base_url>/msp/ticket_list.php?host_id=355311&show_host_id=1

DTD

<platform API server>/ticket_list_output.dtd