/msp/ticket_list_deleted.php
View deleted tickets in the user’s account. This function may be run by Managers. The functionality provided allows for real-time integration with third-party applications.
Basic HTTP authentication is required. Session based authentication is not supported using this API. The XML results returned by the ticket_list_deleted.php function identifies deleted tickets by ticket number and deletion date/time.
Truncation - A maximum of 1,000 deleted tickets can be returned from a single ticket_list_deleted.php request. If this maximum is reached, the function returns a “Truncated after 1,000 records” message at the end of the XML report with the last ticket number included.
Permissions - Only Managers can view deleted tickets.
Select tickets by ticket number or date when tickets were deleted. At least one parameter must be specified.
|
Parameter |
Required/Optional |
Data Type |
Description |
|---|---|---|---|
|
ticket_numbers={nnn,nnn-nnn,...} |
Optional |
Integer |
Specifies certain ticket numbers. Specify one or more ticket numbers and/or ranges. Ticket range start and end is separated by a dash (-). Multiple entries are comma separated. |
|
since_ticket_number={value} |
Optional |
Integer |
Specifies tickets since a certain ticket number. Specify the lowest ticket number to be selected. Selected tickets will have numbers greater than or equal to the ticket number specified. |
|
until_ticket_number={value} |
Optional |
Integer |
Specifies tickets until a certain ticket number. Specify the highest ticket number to be selected. Selected tickets will have numbers less than or equal to the ticket number specified. |
|
deleted_since_datetime={value} |
Optional |
Integer |
Specifies tickets deleted since a certain date/time. Specify a date (required) and time (optional) to identify this timeframe. Tickets deleted on or after the date/time are selected. The date/time is specified in YYYY-MM-DD[THH:MM:SSZ] format (UTC/GMT) like “2006-01-01” or “2006-05-25T23:12:00Z”. |
|
deleted_before_datetime={value} |
Optional |
Integer |
Specifies tickets deleted before a certain date/time. Specify a date (required) and time (optional) to identify this timeframe. Tickets deleted on or before the date/time are selected. The date/time is specified in YYYY-MM-DD[THH:MM:SSZ] format (UTC/GMT) like “2006-01-01” or “2006-05-25T23:12:00Z”. |
API Request
https://<qualys_base_url>/msp/ticket_list_deleted.php?ticket_numbers=120-200API Request
https://<qualys_base_url>/msp/ticket_list_deleted.php?since_ticket_number=400API Request
https://<qualys_base_url>/msp/ticket_list_deleted.php?deleted_since_datetime=2018-01-01<platform API server>/ticket_list_deleted_output.dtd