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