---
title: "PM · Search · Search and load tasks by board, status, assignee, tag, or text"
method: GET
path: "/api/v1/pm/search/tasks"
tags: ["search"]
---

# PM · Search · Search and load tasks by board, status, assignee, tag, or text

`GET /api/v1/pm/search/tasks`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/pm/search/tasks`
- Auth: API key in header `Authorization`

The primary task query endpoint — used by the UI for ALL task loading,
including the board view (no search) and board search box.

IMPORTANT — always scope with `board` + `status`:
The UI always passes `board=<board_id>` and `status=<status_id>` together,
fetching one column at a time (page_size=10). Without scoping, results span
the entire workspace (800+ tasks) with no relevance ranking.

Correct agent pattern:
  1. Call `listStatuses` to get status IDs for the board.
  2. Call `searchTasks?board=<id>&status=<sid>&search=<term>` per column.

Supports nested filters on assignees/tags, date ranges, and full-text
search across title/description/tags/comments.

SUBTASKS ARE EXCLUDED BY DEFAULT — pass `include_subtasks=true` to search
them. A subtask that is absent from every result is not missing or
unindexed; it is filtered out. Confirm with `getTask` by slug before
concluding a ticket does not exist.

## Query parameters

- `search` string
- `board` string, uuid
- `status` string, uuid
- `assignees` string
- `tags` string
- `priority` integer
- `complete` boolean
- `task_type` 'TASK' | 'SUBTASK' | 'CHECKLIST' | 'TEMPLATE'
- `include_subtasks` boolean
- `start_date_after` string, date
- `start_date_before` string, date
- `due_date_after` string, date
- `due_date_before` string, date
- `ordering` string
- `expand` string
- `page` integer
- `page_size` integer

## Headers

- `Organization` string
- `Space` string

## Response `200`

Paginated task search results.

- unknown

---

[API](https://skmtc.dev/simplified/apis/project-manager.md) - [All operations](https://skmtc.dev/simplified/apis/project-manager/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/project-manager/revisions/9ef06e133a13?raw)