List Deleted Tickets

/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.

Input ParametersInput Parameters

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”.

Example - List Deleted Tickets Between Ticket NumbersExample - List Deleted Tickets Between Ticket Numbers

API Request

https://<qualys_base_url>/msp/ticket_list_deleted.php?ticket_numbers=120-200

Example - List Deleted Tickets Since Ticket NumberExample - List Deleted Tickets Since Ticket Number

API Request

https://<qualys_base_url>/msp/ticket_list_deleted.php?since_ticket_number=400

Example - List Tickets Deleted Since Certain DateExample - List Tickets Deleted Since Certain Date

API Request

https://<qualys_base_url>/msp/ticket_list_deleted.php?deleted_since_datetime=2018-01-01

DTD

<platform API server>/ticket_list_deleted_output.dtd