List Tasks
View the tasks in a List. Responses are limited to 100 tasks per page. You can only view task information of tasks you can access.
This action only includes tasks where the specified List ID
is their home List. Tasks added to the List ID
with a different home List are not included in the response.
External Documentation
To learn more, visit the ClickUp documentation.
Basic Parameters
Parameter | Description |
---|---|
Folder ID | The ID of the folder. |
List ID | The ID of the list. To get the list ID: Use the action Get Lists .Or, get it from the ClickUp platform: 1. In the Sidebar, hover over the List and click the ellipsis ... menu. 2. Select Copy link. 3. Use the copied URL to find the listId. The listId is the number that follows /li in the URL. |
Order By | Order by a particular field. By default, tasks are ordered by created. |
Reverse | Tasks are displayed in reverse order. |
Space ID | The ID of the space. |
Statuses | Filter by statuses. To include closed tasks, use the Include Closed parameter. |
Subtasks | Include or exclude subtasks. By default, subtasks are excluded. |
Team ID | The ID of the team (Workspace team type). |
Advanced Parameters
Parameter | Description |
---|---|
Archived | Get archived lists. |
Created After | Retrieve tasks created after a specified date. |
Created Before | Retrieve tasks created before a specified date. |
Include Closed | Include closed tasks. By default, they are excluded. |
Page | Page to fetch (starts at 0). |
Example Output
{
"last_page": 1
"tasks": [
{
"id": "9hx",
"custom_item_id": null,
"name": "New Task Name",
"status": {
"status": "Open",
"color": "#d3d3d3",
"orderindex": 0,
"type": "open"
},
"markdown_description": "Task description",
"orderindex": "1.00000000000000000000000000000000",
"date_created": "1567780450202",
"date_updated": "1567780450202",
"date_closed": null,
"date_done": null,
"creator": {
"id": 183,
"username": "John Doe",
"color": "#827718",
"profilePicture": "https://attachments-public.clickup.com/profilePictures/183_abc.jpg"
},
"assignees": [],
"watchers": [],
"checklists": [],
"tags": [],
"parent": null,
"priority": null,
"due_date": null,
"start_date": null,
"points": 3,
"time_estimate": null,
"time_spent": null,
"custom_fields": {
"id": "0a52c486-5f05-403b-b4fd-c512ff05131c",
"name": "My Text Custom field",
"type": "text",
"type_config": {},
"date_created": "1622176979540",
"hide_from_guests": false,
"value": {
"value": "This is a string of text added to a Custom Field."
},
"required": true
},
"list": {
"id": "123"
},
"folder": {
"id": "456"
},
"space": {
"id": "789"
},
"url": "https://app.clickup.com/t/9hx"
},
{
"id": "9hz",
"custom_item_id": null,
"name": "Second task",
"status": {
"status": "Open",
"color": "#d3d3d3",
"orderindex": 0,
"type": "open"
},
"orderindex": "2.00000000000000000000000000000000",
"date_created": "1567780450202",
"date_updated": "1567780450202",
"date_closed": null,
"date_done": null,
"creator": {
"id": 183,
"username": "John Doe",
"color": "#827718",
"profilePicture": "https://attachments-public.clickup.com/profilePictures/183_abc.jpg"
},
"assignees": [],
"watchers": [],
"checklists": [],
"tags": [],
"parent": null,
"priority": null,
"due_date": null,
"start_date": null,
"points": 3,
"time_estimate": null,
"time_spent": null,
"custom_fields": {
"id": "0a52c486-5f05-403b-b4fd-c512ff05131c",
"name": "My Text Custom field",
"type": "text",
"type_config": {},
"date_created": "1622176979540",
"hide_from_guests": false,
"value": {
"value": "This is a string of text added to a Custom Field."
},
"required": true
},
"list": {
"id": "123"
},
"folder": {
"id": "456"
},
"space": {
"id": "789"
},
"url": "https://app.clickup.com/t/9hz"
}
]
}
Workflow Library Example
List Tasks with Clickup and Send Results Via Email
Preview this Workflow on desktop