---
title: "Get attachments"
method: GET
path: "/api/v2/attachments"
tags: ["Attachments"]
---

# Get attachments

`GET /api/v2/attachments`

List attachments with optional filters and pagination.

## Query parameters

- `sort` string[]
- `filter` union — Filter schema for `attachment` list endpoints — pass a single condition or a logical group.
  - FilterAttachment — Filter parameters for listing attachments. Supports filtering by parent resource (comment, task, deal, page, invoice, expense, purchase order, bill), creator, file type, and upload date. Standard string and ID operators apply.
    - `creator_id` union — Filter by the person who uploaded the attachment.
      - CreatorId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` CreatorId — unresolved $ref
        - `contains` CreatorId — unresolved $ref
        - `not_eq` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref
    - `type` union — Filter by file type (image, video, PDF, text, or other).
      - Type — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` Type — unresolved $ref
        - `eq` Type — unresolved $ref
        - `not_eq` Type — unresolved $ref
        - `not_contain` Type — unresolved $ref
    - `task_id` union — Filter by the associated task.
      - object — Filter using explicit operator syntax.
        - `not_eq` TaskId — unresolved $ref
        - `eq` TaskId — unresolved $ref
        - `contains` TaskId — unresolved $ref
        - `not_contain` TaskId — unresolved $ref
      - TaskId — unresolved $ref
    - `id` union — Filter by attachment ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
    - `fuzzy_dates` union — Filter by fuzzy date range (relative date expression).
      - object — Filter using explicit operator syntax.
        - `eq` FuzzyDates — unresolved $ref
        - `not_eq` FuzzyDates — unresolved $ref
      - FuzzyDates — unresolved $ref
    - `notes_attachment` union — Filter to include only attachments embedded in notes.
      - NotesAttachment — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` NotesAttachment — unresolved $ref
        - `contains` NotesAttachment — unresolved $ref
        - `not_contain` NotesAttachment — unresolved $ref
        - `not_eq` NotesAttachment — unresolved $ref
    - `project_id` union — Filter by the associated project.
      - object — Filter using explicit operator syntax.
        - `eq` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
        - `contains` ProjectId — unresolved $ref
      - ProjectId — unresolved $ref
    - `fuzzy_people` union — Filter by person using fuzzy matching.
      - FuzzyPeople — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` FuzzyPeople — unresolved $ref
        - `contains` FuzzyPeople — unresolved $ref
        - `not_contain` FuzzyPeople — unresolved $ref
        - `not_eq` FuzzyPeople — unresolved $ref
    - `page_id` union — Filter by the associated document page.
      - PageId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` PageId — unresolved $ref
        - `contains` PageId — unresolved $ref
        - `not_contain` PageId — unresolved $ref
        - `eq` PageId — unresolved $ref
    - `comment_id` union — Filter by the associated comment.
      - CommentId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` CommentId — unresolved $ref
        - `contains` CommentId — unresolved $ref
        - `not_eq` CommentId — unresolved $ref
        - `eq` CommentId — unresolved $ref
    - `jump_query` union — Full-text jump search query for quickly finding resources.
      - JumpQuery — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` JumpQuery — unresolved $ref
        - `not_contain` JumpQuery — unresolved $ref
        - `not_eq` JumpQuery — unresolved $ref
        - `eq` JumpQuery — unresolved $ref
    - `company_id` union — Filter by client company.
      - object — Filter using explicit operator syntax.
        - `not_eq` CompanyId — unresolved $ref
        - `contains` CompanyId — unresolved $ref
        - `eq` CompanyId — unresolved $ref
        - `not_contain` CompanyId — unresolved $ref
      - CompanyId — unresolved $ref
    - `full_query` union — Filter by full-text search query.
      - object — Filter using explicit operator syntax.
        - `not_eq` FullQuery — unresolved $ref
        - `contains` FullQuery — unresolved $ref
        - `eq` FullQuery — unresolved $ref
        - `not_contain` FullQuery — unresolved $ref
      - FullQuery — unresolved $ref
  - 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.

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection attachment

---

[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/6bb0150a5c5f/schema)