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

# GET /tasks

`GET /tasks`

By default, list tasks by `created_at` descending, with `id` descending for
tasks created at the same time. Supply the returned `next_cursor` unchanged
to retrieve the next page with the same filters and sort order.

## Query parameters

- `cursor` string
- `limit` integer
- `sort_by` 'created_at'
- `sort_order` 'asc' | 'desc'
- `status` 'NOT_READY' | 'READY' | 'COMPLETED' | 'SKIPPED' | 'CANCELED'
- `assigned_user_id` string, uuid
- `person_id` string, uuid
- `person_email` string, email

## Response `200`

The request has succeeded.

- ListTasksResponse
  - `status` 'success', required
  - `data` Task[], required
    - `id` string, uuid, required
    - `type` 'EMAIL' | 'ACTION_ITEM' | 'PHONE_CALL' | 'LINKEDIN_SEND_MESSAGE' | 'LINKEDIN_SEND_CONNECTION_REQUEST' | 'LINKEDIN_VIEW_PROFILE' | 'REPLY_TO_EMAIL', required
    - `status` 'NOT_READY' | 'READY' | 'COMPLETED' | 'SKIPPED' | 'CANCELED', required
    - `priority` 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT', required
    - `person_id` string, uuid, required
    - `assigned_user_id` string, uuid, required
    - `due_at` string, date-time, nullable, required
    - `ended_at` string, date-time, nullable, required
    - `note_content` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable, required — Opaque cursor for the next page, or null when there are no more tasks.

## Other responses

- `400` — Response for any operation that results in a bad request error.
- `401` — Response for any operation that results in an unauthorized error.
- `403` — Response for any operation that results in a forbidden error.
- `429` — Response for any operation that exceeds a rate limit.
- `500` — Response for any operation that results in an internal server error.

---

[API](https://skmtc.dev/unifygtm/apis/unify-analytics-api.md) · [All operations](https://skmtc.dev/unifygtm/apis/unify-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unifygtm/unify-analytics-api/revisions/2f145e6f6d7e/schema)