---
title: "Get Task"
method: GET
path: "/v1/tasks/{task_id}"
tags: ["tasks"]
---

# Get Task

`GET /v1/tasks/{task_id}`

Fetch a single task.

Requires the `tasks:read` scope on the API key.

## Path parameters

- `task_id` string, uuid, required

## Response `200`

Successful Response

- TaskPublicOutput
  - `id` string, uuid, required — Unique identifier.
  - `organization_id` string, uuid, required — Workspace this task belongs to.
  - `type` 'EMAIL_REPLY' | 'LINKEDIN_REPLY' | 'NEW_LEAD_REVIEW' | 'CALL' | 'PLAYBOOK_APPROVAL' | 'TODO', required
  - `priority` 'HOT' | 'TODAY' | 'EXTRA', required
  - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'SKIPPED', required
  - `title` string, nullable — Task title for standalone tasks.
  - `due_date` string, date, nullable — Due date for standalone tasks.
  - `sequence_id` string, uuid, nullable, required — Sequence run this task was projected from, if any.
  - `contact` PublicContactSummary
    - `id` string, uuid, required — Unique identifier of the contact.
    - `first_name` string, nullable — First name.
    - `last_name` string, nullable — Last name.
    - `email` string, nullable — Email.
    - `linkedin_url` string, nullable — LinkedIn profile URL.
    - `job_title` string, nullable — Job title.
    - `company_name` string, nullable — Employer name.
    - `company_domain` string, nullable — Employer's primary domain.
  - `assignee_user_id` string, uuid, nullable, required — User the task is assigned to, if any.
  - `assignee` PublicUserSummary
    - `id` string, uuid, required — Unique identifier of the user.
    - `name` string, nullable — Display name.
    - `email` string, required — Email address.
  - `sequence_template` PublicSequenceTemplateSummary
    - `id` string, uuid, required — Unique identifier of the sequence template.
    - `name` string, required — Template name.
  - `disposition` 'ANSWERED' | 'VOICEMAIL_LEFT' | 'NO_ANSWER' | 'INTERESTED' | 'NOT_INTERESTED' | 'WRONG_NUMBER', required
  - `reopened_at` string, date-time, nullable, required — When the task was last reopened, if ever.
  - `reopen_reason` 'REMINDER_RULE', required
  - `snoozed_until` string, date-time, nullable — When the task is snoozed until, if deferred.
  - `skipped_at` string, date-time, nullable, required — When the task was skipped, if applicable.
  - `completed_at` string, date-time, nullable, required — When the task was completed, if applicable.
  - `created_at` string, date-time, required — When the task was created.
  - `updated_at` string, date-time, required — When the task last changed.

## Changes

- **2026-08-15** `80f4fd40b75e` — 1 info
  - added the optional property `snoozed_until` to the response with the `200` status
- **2026-08-13** `2f1c56db78f8` — 1 warning
  - added the new `WRONG_NUMBER` enum value to the `disposition/anyOf[subschema #1: CallDisposition]/` response property for the response status `200`
- **2026-08-06** `2bd7bb8e3a37` — 2 warning
  - added the new `INTERESTED` enum value to the `disposition/anyOf[subschema #1: CallDisposition]/` response property for the response status `200`
  - added the new `NOT_INTERESTED` enum value to the `disposition/anyOf[subschema #1: CallDisposition]/` response property for the response status `200`
- **2026-08-04** `467ce2bf692b` — 5 info
  - added the optional property `assignee` to the response with the `200` status
  - added the optional property `contact` to the response with the `200` status
  - added the optional property `due_date` to the response with the `200` status
  - added the optional property `sequence_template` to the response with the `200` status
  - …1 more
- **2026-07-26** `89675e210f34` — 1 warning
  - added the new `TODO` enum value to the `type` response property for the response status `200`

[Change history](https://skmtc.dev/topo/apis/topo-public-api/changes/v1/tasks/:task_id/get.md)

---

[API](https://skmtc.dev/topo/apis/topo-public-api.md) · [All operations](https://skmtc.dev/topo/apis/topo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/topo/topo-public-api/revisions/5327ff62a22f/schema)