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

# Get Tasks

`GET /api/tasks`

## Request

- Base URL: `https://api.vruum.ai`
- URL: `https://api.vruum.ai/api/tasks`
- Auth: `HTTPBearer` (a scheme the document does not define)

List **Vruum CRM** tasks (follow-ups attached to a person / deal / company;
a DB trigger keeps `deals.next_step` synced to the most-recent open task).
Pass `due_today=true` for the "due today" set (status open|in_progress AND
due_at <= now). These are Vruum's native CRM tasks — not Apollo tasks.

## Query parameters

- `assigned_to` string, nullable
- `status` 'open' | 'in_progress' | 'completed' | 'cancelled', nullable
- `person_id` string, nullable
- `deal_id` string, nullable
- `company_id` string, nullable
- `due_before` string, nullable
- `due_after` string, nullable
- `due_today` boolean
- `limit` integer

## Response `200`

Successful Response

- GetTasksResponse
  - `tasks` TaskSummary[], required
    - `id` string, required
    - `user_company_id` string, required
    - `person_id` string, nullable
    - `deal_id` string, nullable
    - `company_id` string, nullable
    - `title` string, required
    - `description` string, nullable
    - `assigned_to` string, nullable
    - `due_at` string, nullable
    - `status` 'open' | 'in_progress' | 'completed' | 'cancelled', required
    - `priority` 'low' | 'medium' | 'high' | 'urgent', nullable
    - `completed_at` string, nullable
    - `created_at` string, required
    - `updated_at` string, required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vruum/apis/vruum-public-api.md) · [All operations](https://skmtc.dev/vruum/apis/vruum-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vruum/apis/vruum-public-api/revisions/b8ada111c30a?raw)