---
title: "Get Task (V1)"
method: GET
path: "/v1.0/tasks/{taskId}"
tags: ["Tasks & Appointments"]
---

# Get Task (V1)

`GET /v1.0/tasks/{taskId}`

Returns a single task by ID, along with the lead's pipeline context. Caller must have manage permission on the lead that owns the task.

## Path parameters

- `taskId` integer, required

## Headers

- `Authorization` string, required

## Response `200`

Task retrieved successfully.

- TaskSingleResponse — Wrapped response for GET /v1.0/tasks/{taskId}. The task entry is returned under the 'task' key.
  - `task` TaskResponse — Task entry, including pipeline context.
    - `id` integer — Task ID.
    - `leadId` integer — ID of the lead this task belongs to.
    - `creatorId` integer — User ID of the task's creator.
    - `content` string — Task description.
    - `type` 'Other' | 'Call' | 'Email' | 'Text' — Type of the task.
    - `deadline` string — Deadline, formatted as 'yyyy-MM-dd HH:mm:ss' in UTC.
    - `finishTime` string — Completion time, formatted as 'yyyy-MM-dd HH:mm:ss' in UTC. Empty string when the task has not been completed.
    - `createTime` string — Creation time, formatted as 'yyyy-MM-dd HH:mm:ss' in UTC.
    - `lastUpdate` string — Last-modified time, formatted as 'yyyy-MM-dd HH:mm:ss' in UTC.
    - `deleteFlag` boolean — Whether the task has been deleted.
    - `finishFlag` boolean — Whether the task has been completed.
    - `overdueFlag` boolean — Whether the task is past its deadline and still open.
    - `leadName` string — Display name of the lead.
    - `leadEmail` string — Email of the lead.
    - `leadPhone` string — Phone number of the lead.
    - `leadFirstName` string — Given name of the lead.
    - `leadLastName` string — Family name of the lead.
    - `reminderType` integer — Reminder type code.
    - `assignedRole` 'Agent' | 'Assistant' — Role the task is assigned to.
    - `assignedUser` string — Display name of the user assigned to this task.
    - `teamId` integer — ID of the team this task belongs to.
    - `subject` string — Subject line. Only meaningful for Email-type tasks.
    - `body` string — Body text. Only meaningful for Email-type tasks.
    - `assignedUserId` integer — User ID of the agent assigned to this task.
    - `pipelineId` integer — Pipeline ID of the associated lead.
    - `queryInfo` string — Query info string for smart plan tasks.
    - `leadUserId` integer — User ID of the lead.
    - `queryId` integer — Smart plan query ID.

## Other responses

- `400` — Caller has no access to the lead that owns the task (20017 PERMISSION_DENIED).
- `401` — Missing or invalid authentication token.
- `404` — Task does not exist or has been deleted (TASK_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/versions/23e640467118/schema)