> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tickets

List all tickets.

By default, only tickets that have been created within the last 30 days are returned.
Use the `Updated Since` parameter for older tickets.

<Note>
  External Documentation

  To learn more, visit the [Freshdesk documentation](https://developers.freshdesk.com/api/#list_all_tickets).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter          | Description                                                                                                                                                                                                                                                                            |
  | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Company ID         | Filter tickets by company ID.                                                                                                                                                                                                                                                          |
  | Email              | Filter tickets by requester email address.                                                                                                                                                                                                                                             |
  | Filter             | Select a predefined filter to apply.                                                                                                                                                                                                                                                   |
  | Include            | Include additional details in the response:<br />  \* `stats` - Returns closed\_at, resolved\_at, and first\_responded\_at timestamps.<br />  \* `requester` - Returns the requester's email, id, mobile, name, and phone.<br />  \* `description` - Returns the ticket's description. |
  | Order By           | Select the field to sort tickets by.                                                                                                                                                                                                                                                   |
  | Page               | The page number of the results to retrieve.                                                                                                                                                                                                                                            |
  | Per Page           | The maximum number of records to return per page. Maximum is 100.                                                                                                                                                                                                                      |
  | Requester ID       | Filter tickets by requester ID.                                                                                                                                                                                                                                                        |
  | Return All Pages   | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                       |
  | Sort Order         | Select the sort direction.                                                                                                                                                                                                                                                             |
  | Unique External ID | Filter tickets by the requester's unique external ID.                                                                                                                                                                                                                                  |
  | Updated Since      | The timestamp after which updated tickets will be retrieved.                                                                                                                                                                                                                           |
</div>

## Example Output

```json theme={"dark"}
[
  {
    "cc_emails" : ["user@cc.com", "user2@cc.com"],
    "fwd_emails" : [ ],
    "reply_cc_emails" : ["user@cc.com", "user2@cc.com"],
    "fr_escalated" : false,
    "spam" : false,
    "email_config_id" : null,
    "group_id" : 2,
    "priority" : 1,
    "requester_id" : 5,
    "responder_id" : 1,
    "source" : 2,
    "source_info": 1,
    "status" : 2,
    "subject" : "Please help",
    "to_emails" : null,
    "product_id" : null,
    "id" : 18,
    "type" : Lead,
    "created_at" : "2015-08-17T12:02:50Z",
    "updated_at" : "2015-08-17T12:02:51Z",
    "due_by" : "2015-08-20T11:30:00Z",
    "fr_due_by" : "2015-08-18T11:30:00Z",
    "is_escalated" : false,
    "structured_description" : {
      "description_contents" : [
        {
          "type" : "text",
          "data" : {
            "content" : "Please help with this issue"
          }
        }
      ]
    },
    "custom_fields" : {
      "category" : "Default"
    }
  }
]
```

## Workflow Library Example

[List Tickets with Freshdesk and Send Results Via Email](https://library.blinkops.com/workflows/list-tickets-with-freshdesk-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-tickets-with-freshdesk-and-send-results-via-email/canvas" />
</div>
