# get\_task\_list
Retrieve a list of tasks per selected and authorized server. For each task, the API returns a few values.
Required User Role: See [Required Enterprise Manager permissions](https://help.qlik.com/en-US/enterprise-manager/May2026/Content/EnterpriseManager/EnterpriseManager_APIGuide/Introduction/AEMPermissions.htm).
## Syntax
`def get_task_list(` `self,` `server` `)`
## Parameters
Parameters
| Parameter | Type | Description |
| --- | --- | --- |
| server | string | The name of the server on which the tasks reside. |
## Return values
AemGetTaskListResp
Return values
| Value | Type | Description |
| --- | --- | --- |
| taskList | List<AemTaskInfo> | An array of Endpoint objects. |
| name | string |
Replicate: - The name of the task.
Compose: - The name of the task or workflow appended with a double underscore and the project name.
Example:
mytask__myproject
|
| state | AemTaskState
{
STOPPED = 0,
RUNNING = 1,
ERROR = 2,
RECOVERY = 3
} | - |
| stop\_reason | AemTaskStopReason
{
NONE = 0,
NORMAL = 1,
RECOVERABLE\_ERROR = 2,
FATAL\_ERROR = 3,
FULL\_LOAD\_ONLY\_FINISHED = 4,
STOPPED\_AFTER\_FULL\_LOAD = 5,
STOPPED\_AFTER\_CACHED\_EVENTS = 6,
EXPRESS\_LICENSE\_LIMITS\_REACHED = 7,
STOPPED\_AFTER\_DDL\_APPLY = 8,
STOPPED\_LOW\_MEMORY = 9,
STOPPED\_LOW\_DISK\_SPACE = 10
} | The reason the task stopped. For Compose tasks, this will always be NONE. |
| message | string | The message if the task stopped due to an error. |
| assigned\_tags | array | Returns the custom tags assigned to the task. If no tags are assigned to the task, an empty array will be returned. |
## Errors
See [general errors](https://help.qlik.com/en-US/enterprise-manager/May2026/Content/EnterpriseManager/EnterpriseManager_APIGuide/NetAPI/error_handling.htm).