---
title: "To get the tasks of a user"
method: GET
path: "/v1/tasks"
tags: ["tasks"]
---

# To get the tasks of a user

`GET /v1/tasks`

## Query parameters

- `page` number
- `pageSize` number
- `sortOrder` 'ASC' | 'DESC'
- `sortBy` 'priority' | 'completedAt' | 'skippedAt' | 'dueDate'
- `status` 'upcoming' | 'dueToday' | 'completed' | 'skipped' | 'overdue'
- `sequenceId` string
- `taskAssignee` string
- `prospectOutcome` string
- `taskType` 'linkedin' | 'call' | 'whatsapp' | 'custom'
- `search` string
- `callOutcome` 'Interested' | 'Callback Later' | 'Followup' | 'Not Interested' | 'Wrong Number' | 'No Answer' | 'Left Voicemail' | 'Not In Service'

## Response `200`

Successfully fetched tasks

- GetTaskDTO
  - `page` number — Page number for pagination
  - `pageSize` number — Number of records per page
  - `sortOrder` 'ASC' | 'DESC' — Sort order for the results
  - `sortBy` 'priority' | 'completedAt' | 'skippedAt' | 'dueDate' — Field to sort by
  - `status` 'upcoming' | 'dueToday' | 'completed' | 'skipped' | 'overdue' — Status of the task
  - `sequenceId` string — Sequence id (hashed)
  - `taskAssignee` string — Task Assignee account id (hashed)
  - `prospectOutcome` string — Prospect outcome
  - `taskType` 'linkedin' | 'call' | 'whatsapp' | 'custom' — Open api task type
  - `search` string — Search term to filter tasks
  - `callOutcome` 'Interested' | 'Callback Later' | 'Followup' | 'Not Interested' | 'Wrong Number' | 'No Answer' | 'Left Voicemail' | 'Not In Service' — Call outcome for filtering tasks

## Other responses

- `400` — 4000: Failed to fetch tasks<br><br>
- `500` — 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) · [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saleshandy/develop-with-saleshandy/revisions/fdaa0f2dcdfb/schema)