---
title: "Get proposals"
method: GET
path: "/api/v2/proposals"
tags: ["Proposals"]
---

# Get proposals

`GET /api/v2/proposals`

List all proposals.

## Query parameters

- `filter` union — Filter schema for `proposal` 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.
  - FilterProposal — Filter parameters for proposals.
    - `link_status` union — Filters proposals by their public link sharing status.
      - LinkStatus — unresolved $ref
      - object — Named-operator filter for the proposal link status.
        - `eq` LinkStatus — unresolved $ref
        - `not_eq` LinkStatus — unresolved $ref
        - `not_contain` LinkStatus — unresolved $ref
        - `contains` LinkStatus — unresolved $ref
    - `created_at` union — Filters proposals by their creation date.
      - object — Named-operator filter for the proposal creation date.
        - `not_eq` CreatedAt — unresolved $ref
        - `eq` CreatedAt — unresolved $ref
        - `not_contain` CreatedAt — unresolved $ref
        - `contains` CreatedAt — unresolved $ref
      - CreatedAt — unresolved $ref
    - `budget_total` union — Filters proposals by their total budget amount.
      - object — Named-operator filter for the proposal budget total amount.
        - `eq` BudgetTotal — unresolved $ref
        - `contains` BudgetTotal — unresolved $ref
        - `not_contain` BudgetTotal — unresolved $ref
        - `not_eq` BudgetTotal — unresolved $ref
      - BudgetTotal — unresolved $ref
    - `sent_at` union — Filters proposals by the date they were sent to the client.
      - SentAt — unresolved $ref
      - object — Named-operator filter for the proposal sent date.
        - `contains` SentAt — unresolved $ref
        - `eq` SentAt — unresolved $ref
        - `not_contain` SentAt — unresolved $ref
        - `not_eq` SentAt — unresolved $ref
    - `deal_id` union — Filter by the associated deal.
      - object — Filter using explicit operator syntax.
        - `not_contain` DealId — unresolved $ref
        - `contains` DealId — unresolved $ref
        - `not_eq` DealId — unresolved $ref
        - `eq` DealId — unresolved $ref
      - DealId — unresolved $ref
    - `responsible_id` union — Filters proposals by the ID of their responsible person.
      - ResponsibleId — unresolved $ref
      - object — Named-operator filter for the proposal responsible person ID.
        - `not_contain` ResponsibleId — unresolved $ref
        - `not_eq` ResponsibleId — unresolved $ref
        - `eq` ResponsibleId — unresolved $ref
        - `contains` ResponsibleId — unresolved $ref
    - `updated_at` union — Filters proposals by their last update date.
      - UpdatedAt — unresolved $ref
      - object — Named-operator filter for the proposal last updated date.
        - `not_eq` UpdatedAt — unresolved $ref
        - `not_contain` UpdatedAt — unresolved $ref
        - `eq` UpdatedAt — unresolved $ref
        - `contains` UpdatedAt — unresolved $ref
    - `status_changed_at` union — Filters proposals by the date their status last changed.
      - object — Named-operator filter for the proposal status change date.
        - `eq` StatusChangedAt — unresolved $ref
        - `not_contain` StatusChangedAt — unresolved $ref
        - `contains` StatusChangedAt — unresolved $ref
        - `not_eq` StatusChangedAt — unresolved $ref
      - StatusChangedAt — unresolved $ref
    - `company_id` union — Filters proposals by the ID of their associated company (client).
      - CompanyId — unresolved $ref
      - object — Named-operator filter for the proposal company ID.
        - `contains` CompanyId — unresolved $ref
        - `eq` CompanyId — unresolved $ref
        - `not_eq` CompanyId — unresolved $ref
        - `not_contain` CompanyId — unresolved $ref
    - `id` union — Filter by ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
    - `status` union — Filter by proposal status.
      - object — Filter using explicit operator syntax.
        - `not_contain` Status — unresolved $ref
        - `not_eq` Status — unresolved $ref
        - `contains` Status — unresolved $ref
        - `eq` Status — unresolved $ref
      - Status — unresolved $ref
    - `creator_id` union — Filters proposals by the ID of the person who created them.
      - object — Named-operator filter for the proposal creator ID.
        - `not_contain` CreatorId — unresolved $ref
        - `not_eq` CreatorId — unresolved $ref
        - `contains` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref
      - CreatorId — unresolved $ref
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection proposal

---

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