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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-03 UTC."],[],[]]