Method: tasklists.list

Returns all the authenticated user's task lists.

HTTP request

GET https://tasks.googleapis.com/tasks/v1/users/@me/lists

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
maxResults

integer

Maximum number of task lists returned on one page. Optional. The default is 20 (max allowed: 100).

pageToken

string

Token specifying the result page to return. Optional.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation
{
  "resource": {
    object (TaskLists)
  }
}
Fields
resource

object (TaskLists)

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

TaskLists

JSON representation
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (TaskList)
    }
  ]
}
Fields
kind

string

Type of the resource. This is always "tasks#taskLists".

etag

string

ETag of the resource.

nextPageToken

string

Token that can be used to request the next page of this result.

items[]

object (TaskList)

Collection of task lists.