List tasks

Important: This API is deprecated and will be removed on May 26th, 2017. We recommend that you use List plannerTasks API.

Retrieve a list of task objects.


One of the following scopes is required to execute this API:

Group.Read.All, Group.ReadWrite.All

HTTP request

GET /plans/{id}/tasks

Optional query parameters

Name Value Description
$expand string Only the relationships of taskBoardTaskFormat type are supported.

Request headers

Name Type Description
Authorization string Value should be set to "Bearer (access-token)"

Request body

Do not supply a request body for this method.


If successful, this method returns a 200 OK response code and collection of task objects in the response body.



Here is an example of the request.


Here is an example of the response.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 772

  "value": [
      "createdBy": "createdBy-value",
      "assignedTo": "assignedTo-value",
      "planId": "planId-value",
      "bucketId": "bucketId-value",
      "title": "title-value",
      "orderHint": "orderHint-value",
      "assigneePriority": "assigneePriority-value",
      "percentComplete": 99,
      "startDateTime": "2016-10-19T10:37:00Z",
      "assignedDateTime": "2016-10-19T10:37:00Z",
      "createdDateTime": "2016-10-19T10:37:00Z",
      "assignedBy": "assignedBy-value",
      "dueDateTime": "2016-10-19T10:37:00Z",
      "hasDescription": true,
      "previewType": "previewType-value",
      "completedDateTime": "2016-10-19T10:37:00Z",
      "appliedCategories": {
      "conversationThreadId": "conversationThreadId-value",
      "id": "id-value"