Method: tasklists.list

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

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

The URL uses gRPC Transcoding syntax.

Parameters

Parameters
`maxResults`	`integer` Maximum number of task lists returned on one page. Optional. The default is 1000 (max allowed: 1000).
`pageToken`	`string` Token specifying the result page to return. Optional.

maxResults

integer

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

pageToken

string

Token specifying the result page to return. Optional.

The request body must be empty.

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.

Requires one of the following OAuth scopes:

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.