ServiceDesk Plus icon

ServiceDesk Plus

Interact with ManageEngine ServiceDesk Plus

Actions11

List Tickets

AI-generated

Overview

This node operation lists tickets from the ManageEngine ServiceDesk Plus system with various filtering options. It allows users to retrieve a list of tickets based on status and intelligent date filters such as specific dates, date ranges, last number of days, or predefined recent periods. This is useful for monitoring, reporting, or managing tickets within a specified timeframe or status category.

Use Case Examples

  1. Retrieve the last 10 tickets regardless of status.
  2. List all open tickets created within a specific date range.
  3. Get tickets created in the last 7 days with status 'In Progress'.
  4. Fetch recent tickets from the last 30 days.

Properties

Name Meaning
Limit Maximum number of tickets to return.
Status Filter Filter tickets by their status (e.g., Open, In Progress, Resolved, Closed).
Date Filter Type Type of date filtering to apply on ticket creation date. Options include none, specific date, date range, last number of days, or recent predefined filters.
Specific Date Filter tickets created on this specific date (used when Date Filter Type is 'specific').
Start Date Start date for the date range filter (used when Date Filter Type is 'range').
End Date End date for the date range filter (used when Date Filter Type is 'range').
Number of Days Number of days to look back from today for filtering (used when Date Filter Type is 'lastDays').
Recent Filter Predefined recent ticket filters to apply (used when Date Filter Type is 'recent').

Output

JSON

  • success - Indicates if the ticket listing operation was successful.
  • tickets - Array of ticket objects returned by the API.
  • count - Number of tickets returned in the response.

Dependencies

  • Requires ManageEngine ServiceDesk Plus API credentials including base URL and authentication token.

Troubleshooting

  • Common issues include invalid or expired API credentials leading to authentication errors.
  • Incorrect date formats or invalid date ranges may cause the API to return errors or empty results.
  • Network connectivity issues can prevent successful API calls.
  • If no tickets are returned, verify that the filters applied (status, date) match existing tickets in the system.

Discussion