> ## 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 Tasks

Gets a list of tasks of your endpoints.

Required API key role permissions:

* `Endpoint Inventory - view`

<Note>
  External Documentation

  To learn more, visit the [Trend Vision One documentation](https://automation.trendmicro.com/xdr/api-v3/#tag/Endpoint-Security/paths/~1v3.0~1endpointSecurity~1tasks/get).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                            |
  | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | End Time         | The end time that indicates the end of the data retrieval time range.                                                                                                                                                                                                                                  |
  | Filter           | Filter for retrieving a subset of the task list.<br /><br />For example: `status eq 'succeeded'`.<br /><br />For further information, please refer to [Trend Vision One Documentation](https://automation.trendmicro.com/xdr/api-v3/#tag/Endpoint-Security/paths/~1v3.0~1endpointSecurity~1tasks/get). |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                       |
  | Start Time       | The start time that indicates the start of the data retrieval time range.                                                                                                                                                                                                                              |
  | Time Target      | The time range to be used for retrieving Workbench alert data.                                                                                                                                                                                                                                         |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter  | Description                                                                                                                                          |
  | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Limit      | The number of results per page.                                                                                                                      |
  | Order By   | Specifies the fields by which the results are sorted.                                                                                                |
  | Skip Token | The pagination token that's used for retrieving the next page of results.<br />It is returned in `nextLink`, as a query parameter named `skipToken`. |
</div>

## Example Output

```json theme={"dark"}
{
	"items": [
		{
			"id": "53cd53d0-6798-4547-ab07-9386cc2c891e",
			"status": "running",
			"action": "export",
			"createdDateTime": "2023-02-08T10:00:00Z",
			"lastActionDateTime": "2023-02-08T10:00:00Z",
			"error": {
				"code": "TaskError",
				"message": "string"
			}
		}
	],
	"count": 1,
	"totalCount": 1,
	"nextLink": "https://api.xdr.trendmicro.com/v3.0/endpointSecurity/tasks?skipToken=skipToken"
}
```

## Workflow Library Example

[List Tasks with Trend Vision One and Send Results Via Email](https://library.blinkops.com/workflows/list-tasks-with-trend-vision-one-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-tasks-with-trend-vision-one-and-send-results-via-email/canvas" />
</div>