Method: tasklists.list

Returns all the authenticated user's task lists. A user can have up to 2000 lists at a time.

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 
{
  "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.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authorization guide.

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.