---
title: "List Tasks"
method: GET
path: "/v1/tasks"
tags: ["tasks"]
---

# List Tasks

`GET /v1/tasks`

List tasks in the workspace.

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

## Query parameters

- `page` integer — Page number.
- `size` integer — Number of items per page.
- `sort_by` 'created_at' | 'updated_at'
- `sort_order` 'asc' | 'desc'
- `sequence_id` string, uuid, nullable — Filter by an individual sequence run.
- `sequence_template_ids` string[], nullable — Filter by sequence template. Repeat the parameter to pass multiple values.
- `types` TaskType[], nullable — Filter by task type. Repeat the parameter to pass multiple values.
- `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'SKIPPED'
- `priorities` TaskPriority[], nullable — Filter by priority bucket. Repeat the parameter to pass multiple values.
- `assignee_user_id` string, uuid, nullable — Filter by assignee.
- `contact_id` string, uuid, nullable — Filter by contact linked to the task or its sequence.
- `created_at_after` string, date-time, nullable — Return tasks created strictly after this timestamp.
- `created_at_before` string, date-time, nullable — Return tasks created strictly before this timestamp.

## Response `200`

Successful Response

- PublicPaginationEnvelopeTaskPublicOutput
  - `items` TaskPublicOutput[], required — Records on this page.
    - `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.
  - `total_count` integer, required — Total number of records matching the query.
  - `total_pages` integer, required — Total number of pages.
  - `has_more` boolean, required — Whether more pages remain after the current one.

---

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