---
title: "Get placeholder usages"
method: GET
path: "/api/v2/placeholder_usages"
tags: ["Placeholder Usages"]
---

# Get placeholder usages

`GET /api/v2/placeholder_usages`

List all placeholder usages.

## Query parameters

- `filter` union — Filter schema for `placeholder_usage` 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.
  - FilterPlaceholderUsage — Filter parameters for placeholder usage records.
    - `todo_id` union — Filter by the associated todo.
      - TodoId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` TodoId — unresolved $ref
        - `not_eq` TodoId — unresolved $ref
        - `eq` TodoId — unresolved $ref
        - `contains` TodoId — unresolved $ref
    - `interval_enabled` union — Filter to include only usages where interval offset is enabled.
      - IntervalEnabled — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` IntervalEnabled — unresolved $ref
        - `not_contain` IntervalEnabled — unresolved $ref
        - `contains` IntervalEnabled — unresolved $ref
        - `not_eq` IntervalEnabled — unresolved $ref
    - `skip_weekends` union — Filter to include only usages where weekends are skipped in interval calculations.
      - SkipWeekends — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` SkipWeekends — unresolved $ref
        - `eq` SkipWeekends — unresolved $ref
        - `not_contain` SkipWeekends — unresolved $ref
        - `not_eq` SkipWeekends — unresolved $ref
    - `field` union — Filter by the date-offset field used for interval calculation.
      - object — Filter using explicit operator syntax.
        - `eq` Field — unresolved $ref
        - `not_eq` Field — unresolved $ref
        - `contains` Field — unresolved $ref
        - `not_contain` Field — unresolved $ref
      - Field — unresolved $ref
    - `placeholder_id` union — Filter by the associated placeholder.
      - PlaceholderId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` PlaceholderId — unresolved $ref
        - `not_eq` PlaceholderId — unresolved $ref
        - `contains` PlaceholderId — unresolved $ref
        - `not_contain` PlaceholderId — unresolved $ref
    - `project_id` union — Filter by the associated project (matches usages on tasks or todos within that project).
      - ProjectId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
    - `task_id` union — Filter by the associated task.
      - object — Filter using explicit operator syntax.
        - `eq` TaskId — unresolved $ref
        - `contains` TaskId — unresolved $ref
        - `not_eq` TaskId — unresolved $ref
        - `not_contain` TaskId — unresolved $ref
      - TaskId — unresolved $ref
    - `target_id` union — Filter by the target resource ID (the task or todo the placeholder is applied to).
      - object — Filter using explicit operator syntax.
        - `not_contain` TargetId — unresolved $ref
        - `eq` TargetId — unresolved $ref
        - `not_eq` TargetId — unresolved $ref
        - `contains` TargetId — unresolved $ref
      - TargetId — unresolved $ref
    - `target_type` union — Filter by the target resource type (task or todo).
      - TargetType — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` TargetType — unresolved $ref
        - `not_eq` TargetType — unresolved $ref
        - `eq` TargetType — unresolved $ref
        - `contains` TargetType — unresolved $ref
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection placeholder usage

---

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