---
title: "Get placeholders"
method: GET
path: "/api/v2/placeholders"
tags: ["Placeholders"]
---

# Get placeholders

`GET /api/v2/placeholders`

List all placeholders.

## Query parameters

- `sort` string[]
- `filter` union — Filter schema for `placeholder` 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.
  - FilterPlaceholder — Filter parameters for resource planning placeholders.
    - `category` union — Filter by placeholder category.
      - object — Filter using explicit operator syntax.
        - `contains` Category — unresolved $ref
        - `not_eq` Category — unresolved $ref
        - `eq` Category — unresolved $ref
        - `not_contain` Category — unresolved $ref
      - Category — unresolved $ref
    - `created_at` union — Filter by creation date range.
      - object — Filter using explicit operator syntax.
        - `contains` CreatedAt — unresolved $ref
        - `eq` CreatedAt — unresolved $ref
        - `not_contain` CreatedAt — unresolved $ref
        - `not_eq` CreatedAt — unresolved $ref
      - CreatedAt — unresolved $ref
    - `query` union — Filter placeholders by name (text search on the name field).
      - Query — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` Query — unresolved $ref
        - `not_contain` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `eq` Query — unresolved $ref
    - `type` union — Filter by placeholder type.
      - Type — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` Type — unresolved $ref
        - `eq` Type — unresolved $ref
        - `contains` Type — unresolved $ref
        - `not_eq` Type — unresolved $ref
    - `name` union — Filter by name (text search).
      - object — Filter using explicit operator syntax.
        - `not_contain` Name — unresolved $ref
        - `eq` Name — unresolved $ref
        - `contains` Name — unresolved $ref
        - `not_eq` Name — unresolved $ref
      - Name — unresolved $ref
    - `usage_project_id` union — Filter placeholders that are used in tasks or todos belonging to the specified project.
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `contains` UsageProjectId — unresolved $ref
        - `not_contain` UsageProjectId — unresolved $ref
        - `eq` UsageProjectId — unresolved $ref
        - `not_eq` UsageProjectId — unresolved $ref
      - UsageProjectId — unresolved $ref
    - `project_id` union — Filter by the associated project.
      - ProjectId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
        - `contains` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
    - `id` union — Filter by ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `eq` Id — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection placeholder

---

[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)