---
title: "List Chat Tasks"
method: GET
path: "/team-messaging/v1/chats/{chatId}/tasks"
tags: ["Tasks"]
---

# List Chat Tasks

`GET /team-messaging/v1/chats/{chatId}/tasks`

Returns the list of tasks of the specified chat.

## Path parameters

- `chatId` string, required

## Query parameters

- `creationTimeTo` string
- `creationTimeFrom` string
- `creatorId` string[]
- `status` string[]
- `assignmentStatus` 'Unassigned' | 'Assigned'
- `assigneeId` string[]
- `assigneeStatus` 'Pending' | 'Completed'
- `pageToken` string
- `recordCount` integer

## Response `200`

OK

- TMTaskList
  - `records` TMTaskInfo[]
    - `id` string — Internal identifier of a task
    - `creationTime` string, date-time — Task creation date/time in UTC time zone
    - `lastModifiedTime` string, date-time — Task the last modified time in UTC time zone
    - `type` 'Task' — Task type
    - `creator` object
      - `id` string — Internal identifier of a task creator
    - `chatIds` string[] — Internal identifiers of the chats where the task is posted or shared
    - `status` 'Pending' | 'InProgress' | 'Completed' — Task execution status
    - `subject` string — Task name/subject
    - `assignees` object[] — Task name/subject
      - `id` string — Internal identifier of an assignee
      - `status` 'Pending' | 'Completed' — Task execution status by assignee
    - `completenessCondition` 'Simple' | 'AllAssignees' | 'Percentage' — How the task completeness should be determined
    - `completenessPercentage` integer — Current completeness percentage of the task with the specified percentage completeness condition
    - `startDate` string, date-time — Task start date
    - `dueDate` string, date-time — Task due date/time
    - `color` 'Black' | 'Red' | 'Orange' | 'Yellow' | 'Green' | 'Blue' | 'Purple' | 'Magenta' — Font color of a post with the current task
    - `section` string — Task section to group / search by
    - `description` string — Task details
    - `recurrence` TaskRecurrenceInfo — Task information
      - `schedule` 'None' | 'Daily' | 'Weekdays' | 'Weekly' | 'Monthly' | 'Yearly' — Recurrence settings of a task. None for non-periodic tasks
      - `endingCondition` 'None' | 'Count' | 'Date' — Ending condition of a task
      - `endingAfter` integer — Count of iterations of periodic tasks
      - `endingOn` string, date-time — End date of a periodic task in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format, UTC time zone
    - `attachments` TaskAttachment[]
      - `id` string — File ID.
      - `type` 'File' — Possible value - File. Attachment type (currently, only File is possible)
      - `name` string — Name of the attached file (incl. extension name)
      - `contentUri` string, uri — URI
  - `navigation` TMNavigationInfo
    - `prevPageToken` string — Previous page token. To get previous page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens
    - `nextPageToken` string — Next page token. To get next page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens

## Other responses

- `400` — Invalid input parameter(-s)
- `403` — Forbidden
- `404` — Specified chat ID does not exist

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)