# RemoteGetDocumentTask Method

## Overloads

| [RemoteGetDocumentTask(Guid, Guid, DocumentTaskScope)](https://help.qlik.com/en-US/qlikview-developer/September2025/Subsystems/QMSAPIref/Content/PIX.Services.V12.Api6.IQMS6.RemoteGetDocumentTask.htm#PIX_Services_V12_Api6_IQMS6_RemoteGetDocumentTask_System_Guid_System_Guid_PIX_QMSAPI_DataObjects_DocumentTaskScope_) |  | Retrieves a single task from a remote QlikView Management Service. |
| --- | --- | --- |

[](https://help.qlik.com/en-US/qlikview-developer/Subsystems/QMSAPIref/Content/PIX.Services.V12.Api6.IQMS6.RemoteGetDocumentTask.htm) [](https://help.qlik.com/en-US/qlikview-developer/Subsystems/QMSAPIref/Content/PIX.Services.V12.Api6.IQMS6.RemoteGetDocumentTask.htm)

## RemoteGetDocumentTask(Guid, Guid, DocumentTaskScope)

Retrieves a single task from a remote QlikView Management Service.

### Declaration

```

          DocumentTask RemoteGetDocumentTask(Guid remoteQmsId, Guid taskId, DocumentTaskScope scope)
    
  
```

### Parameters

| Type | Name | Description |
| --- | --- | --- |
| System.Guid | remoteQmsId | The ID of the remote QlikView Management Service. |
| System.Guid | taskId | The ID of the task to import. |
| [DocumentTaskScope](https://help.qlik.com/en-US/qlikview-developer/September2025/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.DocumentTaskScope.htm) | scope | The scope identifies which settings of the task to retrieve. |

### Returns

| Type | Description |
| --- | --- |
| [DocumentTask](https://help.qlik.com/en-US/qlikview-developer/September2025/Subsystems/QMSAPIref/Content/PIX.QMSAPI.DataObjects.DocumentTask.htm) | A document task. |

### Remarks

Each document can have tasks associated with it.

##### security

Requires membership of local group *QlikView Management API* and the role *Document Folder Administrator*.

### Examples

This example retrieves detailed information about all tasks for a specific document.

The service key injection is assumed to be handled behind the scenes. For an example of how to inject the service key, see Samples.

```
using System;
using System.Collections.Generic;
using System.Linq;
using QMSAPI;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            // create a QMS API client
            IQMS apiClient = new QMSClient();

            //retrieve a time limited service key
            ServiceKeyClientMessageInspector.ServiceKey = apiClient.GetTimeLimitedServiceKey();

            //Get a remote QlikView Management service.
            ServiceInfo remoteQMSService = apiClient.GetServices(ServiceTypes.RemoteQlikViewManagementService).FirstOrDefault();

            if (remoteQMSService != null)
            {
                Guid docId = new Guid ("12a32214-1122-112a-8099-8765ce564112"); // The document ID.

                //Get a list of tasks for the document.
                List<TaskInfo> taskInfos = apiClient.RemoteGetTaskListForDocID(remoteQMSService.ID, docId);
                taskInfos.ForEach( delegate (TaskInfo taskInfo)
                    {
                        //Retrieve full information about the task.
                        DocumentTask documentTask = apiClient.RemoteGetDocumentTask(remoteQMSService.ID, taskInfo.ID, DocumentTaskScope.All);

                        if (documentTask == null) return;

                        Console.WriteLine("Name:" + documentTask.General.TaskName);
                        Console.WriteLine("Description" + documentTask.General.TaskDescription);
                        Console.WriteLine();
                    }
                );
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("An exception occurred: " + ex.Message);
        }
        // wait for user to press any key
        Console.ReadLine();
    }
}
```