---
title: "Get todos"
method: GET
path: "/api/v2/todos"
tags: ["Todos"]
---

# Get todos

`GET /api/v2/todos`

Returns a paginated list of todos — checklist items attached to tasks or deals. Supports filtering by assignee, due date, task, deal, todoable type, and status (open/closed).

## Query parameters

- `sort` string[]
- `filter` union — Filter schema for `todo` list endpoints — pass a single condition or a logical group.
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
  - FilterTodo — Filter parameters for listing todos (checklist items). Supports filtering by parent resource (task or deal), assignee, completion status, due date, and position. Standard ID and date operators apply.
    - `assignee_id` union — Filter by the assigned person.
      - AssigneeId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` AssigneeId — unresolved $ref
        - `contains` AssigneeId — unresolved $ref
        - `eq` AssigneeId — unresolved $ref
        - `not_contain` AssigneeId — unresolved $ref
    - `id` union — Filter by todo ID.
      - object — Filter using explicit operator syntax.
        - `not_contain` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
      - Id — unresolved $ref
    - `deal_id` union — Filter by the associated deal.
      - object — Filter using explicit operator syntax.
        - `not_contain` DealId — unresolved $ref
        - `not_eq` DealId — unresolved $ref
        - `contains` DealId — unresolved $ref
        - `eq` DealId — unresolved $ref
      - DealId — unresolved $ref
    - `due_date` union — Filter by due date range.
      - DueDate — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` DueDate — unresolved $ref
        - `not_eq` DueDate — unresolved $ref
        - `contains` DueDate — unresolved $ref
        - `not_contain` DueDate — unresolved $ref
    - `task_id` union — Filter by the associated task.
      - object — Filter using explicit operator syntax.
        - `contains` TaskId — unresolved $ref
        - `not_eq` TaskId — unresolved $ref
        - `not_contain` TaskId — unresolved $ref
        - `eq` TaskId — unresolved $ref
      - TaskId — unresolved $ref
    - `todoable_type` union — Filter by the type of parent resource the todo belongs to (task or deal).
      - object — Filter using explicit operator syntax.
        - `contains` TodoableType — unresolved $ref
        - `not_contain` TodoableType — unresolved $ref
        - `not_eq` TodoableType — unresolved $ref
        - `eq` TodoableType — unresolved $ref
      - TodoableType — unresolved $ref
    - `status` union — Filter by completion status (open or closed).
      - Status — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` Status — unresolved $ref
        - `not_eq` Status — unresolved $ref
        - `not_contain` Status — unresolved $ref
        - `eq` Status — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection todo

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/11e8576224b8/schema)