---
title: "Get Task"
method: GET
path: "/team-messaging/v1/tasks/{taskId}"
tags: ["Tasks"]
---

# Get Task

`GET /team-messaging/v1/tasks/{taskId}`

Returns information about the specified task(s) by ID(s).

## Path parameters

- `taskId` string, required

## Response `200`

OK

- 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

## Other responses

- `400` — Invalid input parameter(-s)
- `403` — Forbidden
- `404` — Requested task 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/versions/8d602198ec97/schema)