---
title: "Get proposal reports"
method: GET
path: "/api/v2/reports/proposal_reports"
tags: ["Reports"]
---

# Get proposal reports

`GET /api/v2/reports/proposal_reports`

Returns a paginated list of proposal report records, suitable for building custom proposal analytics.

## Query parameters

- `group` 'company' | 'created_at' | 'creator' | 'currency' | 'date_signed' | 'deal' | 'link_status' | 'organization' | 'proposal' | 'responsible' | 'sent_at' | 'signed' | 'status' | 'status_changed_at' | 'subsidiary' | 'updated_at'
- `sort` string[]
- `filter` union — Filter parameters for listing proposal report entries.
  - object — A single filter condition object for proposal report queries, using named operators.
    - `$op` 'or' | 'and', required — Logical operator combining multiple filter conditions (e.g. `AND`, `OR`).
  - FilterProposalReport — Filter parameters for querying proposal report data.
    - `sent_at` union — Filters proposal report rows by the date the proposal was sent.
      - object — Named-operator filter for sent date in proposal reports.
        - `contains` SentAt — unresolved $ref
        - `not_eq` SentAt — unresolved $ref
        - `not_contain` SentAt — unresolved $ref
        - `eq` SentAt — unresolved $ref
      - SentAt — unresolved $ref
    - `deal_id` union — Filters proposal report rows by the associated deal ID.
      - object — Named-operator filter for deal ID in proposal reports.
        - `not_eq` DealId — unresolved $ref
        - `eq` DealId — unresolved $ref
        - `contains` DealId — unresolved $ref
        - `not_contain` DealId — unresolved $ref
      - DealId — unresolved $ref
    - `budget_total` union — Filters proposal report rows by the proposal budget total amount.
      - object — Named-operator filter for the budget total in proposal reports.
        - `contains` BudgetTotal — unresolved $ref
        - `not_eq` BudgetTotal — unresolved $ref
        - `not_contain` BudgetTotal — unresolved $ref
        - `eq` BudgetTotal — unresolved $ref
      - BudgetTotal — unresolved $ref
    - `formulas` union — Filters proposal report rows by custom formula field values.
      - object — Named-operator filter for formula field values in proposal reports.
        - `not_eq` Formulas — unresolved $ref
        - `contains` Formulas — unresolved $ref
        - `not_contain` Formulas — unresolved $ref
        - `eq` Formulas — unresolved $ref
      - Formulas — unresolved $ref
    - `id` union — Filters proposal report rows by their report entry ID.
      - object — Named-operator filter for the proposal report entry ID.
        - `not_contain` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `eq` Id — unresolved $ref
      - Id — unresolved $ref
    - `link_status` union — Filters proposal report rows by the proposal public link status.
      - LinkStatus — unresolved $ref
      - object — Named-operator filter for link status in proposal reports.
        - `eq` LinkStatus — unresolved $ref
        - `not_contain` LinkStatus — unresolved $ref
        - `not_eq` LinkStatus — unresolved $ref
        - `contains` LinkStatus — unresolved $ref
    - `status` union — Filters proposal report rows by the proposal status (e.g. draft, sent, accepted).
      - object — Named-operator filter for proposal status in proposal reports.
        - `contains` Status — unresolved $ref
        - `not_contain` Status — unresolved $ref
        - `eq` Status — unresolved $ref
        - `not_eq` Status — unresolved $ref
      - Status — unresolved $ref
    - `tax_amount` union — Filters proposal report rows by the calculated tax amount.
      - TaxAmount — unresolved $ref
      - object — Named-operator filter for tax amount in proposal reports.
        - `eq` TaxAmount — unresolved $ref
        - `not_eq` TaxAmount — unresolved $ref
        - `not_contain` TaxAmount — unresolved $ref
        - `contains` TaxAmount — unresolved $ref
    - `date_signed` union — Filters proposal report rows by the date the proposal was signed.
      - DateSigned — unresolved $ref
      - object — Named-operator filter for the date signed in proposal reports.
        - `eq` DateSigned — unresolved $ref
        - `not_eq` DateSigned — unresolved $ref
        - `contains` DateSigned — unresolved $ref
        - `not_contain` DateSigned — unresolved $ref
    - `created_at` union — Filters proposal report rows by the proposal creation date.
      - object — Named-operator filter for creation date in proposal reports.
        - `contains` CreatedAt — unresolved $ref
        - `not_eq` CreatedAt — unresolved $ref
        - `not_contain` CreatedAt — unresolved $ref
        - `eq` CreatedAt — unresolved $ref
      - CreatedAt — unresolved $ref
    - `responsible_id` union — Filters proposal report rows by the responsible person ID.
      - ResponsibleId — unresolved $ref
      - object — Named-operator filter for responsible person ID in proposal reports.
        - `not_eq` ResponsibleId — unresolved $ref
        - `eq` ResponsibleId — unresolved $ref
        - `not_contain` ResponsibleId — unresolved $ref
        - `contains` ResponsibleId — unresolved $ref
    - `company_id` union — Filters proposal report rows by the associated company ID.
      - object — Named-operator filter for company ID in proposal reports.
        - `contains` CompanyId — unresolved $ref
        - `not_eq` CompanyId — unresolved $ref
        - `eq` CompanyId — unresolved $ref
        - `not_contain` CompanyId — unresolved $ref
      - CompanyId — unresolved $ref
    - `updated_at` union — Filters proposal report rows by the last update date.
      - UpdatedAt — unresolved $ref
      - object — Named-operator filter for updated date in proposal reports.
        - `not_contain` UpdatedAt — unresolved $ref
        - `eq` UpdatedAt — unresolved $ref
        - `contains` UpdatedAt — unresolved $ref
        - `not_eq` UpdatedAt — unresolved $ref
    - `status_changed_at` union — Filters proposal report rows by the date the proposal status last changed.
      - object — Named-operator filter for status change date in proposal reports.
        - `contains` StatusChangedAt — unresolved $ref
        - `not_contain` StatusChangedAt — unresolved $ref
        - `eq` StatusChangedAt — unresolved $ref
        - `not_eq` StatusChangedAt — unresolved $ref
      - StatusChangedAt — unresolved $ref
    - `creator_id` union — Filters proposal report rows by the creator person ID.
      - CreatorId — unresolved $ref
      - object — Named-operator filter for creator ID in proposal reports.
        - `not_eq` CreatorId — unresolved $ref
        - `contains` CreatorId — unresolved $ref
        - `not_contain` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

A paginated collection of proposal report resources.

---

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