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

# List tasks

`GET /tasks`

Returns a list of tasks. Uses cursor pagination.

## Query parameters

- `limit` integer
- `cursor` string
- `modifiedSince` string, date-time
- `modifiedUntil` string, date-time
- `candidateIds` string[]
- `clientContactIds` string[]
- `vacancyIds` string[]
- `companyIds` string[]
- `opportunityIds` string[]
- `sources` string[]
- `labelIds` string[]

## Response `200`

Successfully retrieved tasks. Returns items array with pagination info containing cursor for the next page.

- GetTasksResponseDto
  - `items` GetTaskDto[], required
    - `id` string, required
    - `content` string, required
    - `dueDate` string, date-time, required
    - `isCompleted` boolean, required
    - `completedAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `createdBy` UserBadgeDto, required
      - `id` string, required
      - `name` string, required
      - `avatarUrl` string, nullable, required
      - `deactivatedAt` string, date-time, required
    - `assignedTo` UserBadgeDto, required
      - `id` string, required
      - `name` string, required
      - `avatarUrl` string, nullable, required
      - `deactivatedAt` string, date-time, required
    - `source` 'MANUAL' | 'AI_SUGGESTION' | 'OUTREACH_SEQUENCE_STEP' | 'AUTOMATION', required
    - `metadata` union, required
      - object
        - `outreachSequenceId` string, required
        - `outreachSequenceName` string, required
        - `outreachSequenceRunId` string, required
        - `type` 'GENERIC_TASK', required
      - object
        - `outreachSequenceId` string, required
        - `outreachSequenceName` string, required
        - `outreachSequenceRunId` string, required
        - `type` 'PHONE_CALL_TASK', required
        - `phoneNumber` string, nullable, required
      - object
        - `outreachSequenceId` string, required
        - `outreachSequenceName` string, required
        - `outreachSequenceRunId` string, required
        - `type` 'LINKEDIN_CONNECTION_REQUEST_TASK', required
        - `linkedInUrl` string, nullable, required
      - object
        - `outreachSequenceId` string, required
        - `outreachSequenceName` string, required
        - `outreachSequenceRunId` string, required
        - `type` 'LINKEDIN_MESSAGE_TASK', required
        - `linkedInUrl` string, nullable, required
        - `messageBody` string, nullable, required
      - object
        - `outreachSequenceId` string, required
        - `outreachSequenceName` string, required
        - `outreachSequenceRunId` string, required
        - `type` 'WHATSAPP_MESSAGE_TASK', required
        - `phoneNumber` string, nullable, required
        - `messageBody` string, nullable, required
    - `labels` TaskLabelDto[], required
      - `id` string, required
      - `name` string, required
      - `colorHex` string, required
    - `links` GetTaskLinksDto, required
      - `candidates` TaskLinkIdDto[], required
        - `id` string, required
      - `vacancies` TaskLinkIdDto[], required
        - `id` string, required
      - `clients` TaskLinkIdDto[], required
        - `id` string, required
      - `users` TaskLinkIdDto[], required
        - `id` string, required
      - `teams` TaskLinkIdDto[], required
        - `id` string, required
      - `clientContacts` TaskLinkIdDto[], required
        - `id` string, required
      - `opportunities` TaskLinkIdDto[], required
        - `id` string, required
  - `pageInfo` CursorPageInfoDto, required
    - `nextCursor` string, nullable, required — Deprecated: use pagination.cursor instead.
    - `hasNextPage` boolean, required — Deprecated: use the presence of pagination.cursor instead.

## Other responses

- `400` — Bad request - invalid query parameters (e.g., limit out of range, invalid date format)
- `401` — Unauthorized - invalid or missing authentication
- `500` — Error response

---

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