​
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

ParameterDescription
Folder IDThe ID of the folder.
List IDThe 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 ByOrder by a particular field. By default, tasks are ordered by created.
ReverseTasks are displayed in reverse order.
Space IDThe ID of the space.
StatusesFilter by statuses. To include closed tasks, use the Include Closed parameter.
SubtasksInclude or exclude subtasks. By default, subtasks are excluded.
Team IDThe ID of the team (Workspace team type).

​
Advanced Parameters

ParameterDescription
ArchivedGet archived lists.
Created AfterRetrieve tasks created after a specified date.
Created BeforeRetrieve tasks created before a specified date.
Include ClosedInclude closed tasks. By default, they are excluded.
PagePage 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

Was this page helpful?

List Task CommentsList Webhooks