Use Tasks Parameters

Stay organized with collections Save and categorize content based on your preferences.

In addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.

Request parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.

Parameter Meaning Notes Applicability
completedMax Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by.
  • Default: completedMax=2031-01-01
  • Use the RFC 3339 timestamp format. For example: 2010-08-09T10:57:00.000-08:00
  • Retrieving tasks
completedMin Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by.
  • Default: completedMin=1970-01-01
  • Use the RFC 3339 timestamp format. For example: 2010-08-09T10:57:00.000-08:00
  • Retrieving tasks
dueMax Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by.
  • Default: dueMax=2031-01-01
  • Use the RFC 3339 timestamp format. For example: 2010-08-09T10:57:00.000-08:00
  • Retrieving tasks
dueMin Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by.
  • Default: dueMin=1970-01-01
  • Use the RFC 3339 timestamp format. For example: 2010-08-09T10:57:00.000-08:00
  • Retrieving tasks
maxResults The maximum number of elements to return with this request.
  • Default: maxResults=20
  • Maximum allowable value: maxResults=100.
  • Retrieving a user's task lists
  • Retrieving tasks
pageToken Token specifying the result page to return.
  • The default is to return the first page.
  • Retrieving a user's task lists
  • Retrieving tasks
parent Specify the task's parent task ID.
  • No parameter indicates an insertion or a move to the top level of the task list.
  • Creating a task
  • Ordering a task
previous Specify the task's previous task ID.
  • No parameter indicates an insertion or a move to the first position in the sublist.
  • Creating a task
  • Ordering a task
showCompleted Specify whether or not to show completed tasks.
  • Default: showCompleted=true
  • Retrieving tasks
showDeleted Specify whether or not to show deleted tasks.
  • Default: showDeleted=false
  • Retrieving tasks
showHidden Specify whether or not to show hidden tasks.
  • Default: showHidden=true
  • Retrieving tasks
updatedMin Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by.
  • Use the RFC 3339 timestamp format. For example: 2010-08-09T10:57:00.000-08:00Z.
  • The default is not to filter by last modification time.
  • Retrieving tasks