---
title: "Get deal statuses"
method: GET
path: "/api/v2/deal_statuses"
tags: ["Deal Statuses"]
---

# Get deal statuses

`GET /api/v2/deal_statuses`

List deal statuses with optional filters and pagination.

## Query parameters

- `sort` string[]
- `filter` union — Filter schema for `deal_status` 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.
  - FilterDealStatus — Filter parameters for listing deal statuses. Supports filtering by pipeline and status category. Standard ID operators apply.
    - `expense_tracking_enabled` union — Filter to stages with expense tracking enabled or disabled.
      - object — Filter using explicit operator syntax.
        - `contains` ExpenseTrackingEnabled — unresolved $ref
        - `not_contain` ExpenseTrackingEnabled — unresolved $ref
        - `not_eq` ExpenseTrackingEnabled — unresolved $ref
        - `eq` ExpenseTrackingEnabled — unresolved $ref
      - ExpenseTrackingEnabled — unresolved $ref
    - `pipeline_id` union — Filter by associated pipeline.
      - PipelineId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` PipelineId — unresolved $ref
        - `not_contain` PipelineId — unresolved $ref
        - `contains` PipelineId — unresolved $ref
        - `eq` PipelineId — unresolved $ref
    - `query` union — Filter by deal status name (text search).
      - Query — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `not_contain` Query — unresolved $ref
    - `pipeline_type_id` union — Filter by pipeline type (sales or production).
      - PipelineTypeId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_contain` PipelineTypeId — unresolved $ref
        - `not_eq` PipelineTypeId — unresolved $ref
        - `eq` PipelineTypeId — unresolved $ref
        - `contains` PipelineTypeId — unresolved $ref
    - `probability_enabled` union — Filter to stages with probability tracking enabled or disabled.
      - object — Filter using explicit operator syntax.
        - `contains` ProbabilityEnabled — unresolved $ref
        - `eq` ProbabilityEnabled — unresolved $ref
        - `not_eq` ProbabilityEnabled — unresolved $ref
        - `not_contain` ProbabilityEnabled — unresolved $ref
      - ProbabilityEnabled — unresolved $ref
    - `id` union — Filter by deal status ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
    - `status_id` union — Filter by pipeline stage outcome (open, won, lost, delivered).
      - object — Filter using explicit operator syntax.
        - `eq` StatusId — unresolved $ref
        - `not_contain` StatusId — unresolved $ref
        - `not_eq` StatusId — unresolved $ref
        - `contains` StatusId — unresolved $ref
      - StatusId — unresolved $ref
    - `lost_reason_enabled` union — Filter to stages where lost reason entry is enabled or disabled.
      - LostReasonEnabled — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `contains` LostReasonEnabled — unresolved $ref
        - `not_contain` LostReasonEnabled — unresolved $ref
        - `not_eq` LostReasonEnabled — unresolved $ref
        - `eq` LostReasonEnabled — unresolved $ref
    - `booking_tracking_enabled` union — Filter to stages with booking tracking enabled or disabled.
      - object — Filter using explicit operator syntax.
        - `not_eq` BookingTrackingEnabled — unresolved $ref
        - `eq` BookingTrackingEnabled — unresolved $ref
        - `contains` BookingTrackingEnabled — unresolved $ref
        - `not_contain` BookingTrackingEnabled — unresolved $ref
      - BookingTrackingEnabled — unresolved $ref
    - `time_tracking_enabled` union — Filter to stages with time tracking enabled or disabled.
      - TimeTrackingEnabled — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` TimeTrackingEnabled — unresolved $ref
        - `not_eq` TimeTrackingEnabled — unresolved $ref
        - `not_contain` TimeTrackingEnabled — unresolved $ref
        - `contains` TimeTrackingEnabled — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection deal status

---

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