---
title: "Get deals"
method: GET
path: "/api/v2/deals"
tags: ["Deals"]
---

# Get deals

`GET /api/v2/deals`

List deals with optional filters. Returns paginated deal records the caller has access to.

## Query parameters

- `filter` union — Filter schema for `deal` 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.
  - FilterDeal — Filter parameters for querying deals (sales pipeline opportunities).
    - `creator_id` union — Filter by the person who created the deal.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` CreatorId — unresolved $ref
        - `contains` CreatorId — unresolved $ref
        - `not_contain` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref
      - CreatorId — unresolved $ref
    - `lost_at` union — Filter by lost date range (`lost_at`).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` LostAt — unresolved $ref
        - `not_eq` LostAt — unresolved $ref
        - `contains` LostAt — unresolved $ref
        - `not_contain` LostAt — unresolved $ref
      - LostAt — unresolved $ref
    - `won_at` union — Filter by won date range (`won_at`).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` WonAt — unresolved $ref
        - `not_contain` WonAt — unresolved $ref
        - `not_eq` WonAt — unresolved $ref
        - `eq` WonAt — unresolved $ref
      - WonAt — unresolved $ref
    - `discount` union — Filter by discount percentage range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` Discount — unresolved $ref
        - `contains` Discount — unresolved $ref
        - `not_contain` Discount — unresolved $ref
        - `eq` Discount — unresolved $ref
      - Discount — unresolved $ref
    - `fuzzy_people` union — Filter by associated people using fuzzy matching.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` FuzzyPeople — unresolved $ref
        - `not_contain` FuzzyPeople — unresolved $ref
        - `not_eq` FuzzyPeople — unresolved $ref
        - `contains` FuzzyPeople — unresolved $ref
      - FuzzyPeople — unresolved $ref
    - `future_cost` union — Filter by future cost amount range.
      - FutureCost — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` FutureCost — unresolved $ref
        - `not_contain` FutureCost — unresolved $ref
        - `contains` FutureCost — unresolved $ref
        - `eq` FutureCost — unresolved $ref
    - `type` union — Filter by deal type (sales deal or production budget).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Type — unresolved $ref
        - `not_contain` Type — unresolved $ref
        - `not_eq` Type — unresolved $ref
        - `contains` Type — unresolved $ref
      - Type — unresolved $ref
    - `number` union — Filter by deal/quote number (text search).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` Number — unresolved $ref
        - `eq` Number — unresolved $ref
        - `not_eq` Number — unresolved $ref
        - `not_contain` Number — unresolved $ref
      - Number — unresolved $ref
    - `days_since_last_activity` union — Filter by the number of days since the last activity was recorded on the deal (`last_activity_at`).
      - DaysSinceLastActivity — unresolved $ref
      - object — Object form with operator key (eq, not_eq, contains, not_contain).
        - `contains` DaysSinceLastActivity — unresolved $ref
        - `not_eq` DaysSinceLastActivity — unresolved $ref
        - `not_contain` DaysSinceLastActivity — unresolved $ref
        - `eq` DaysSinceLastActivity — unresolved $ref
    - `jump_query` union — Filter by deal name or number (quick jump search).
      - JumpQuery — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` JumpQuery — unresolved $ref
        - `contains` JumpQuery — unresolved $ref
        - `not_contain` JumpQuery — unresolved $ref
        - `eq` JumpQuery — unresolved $ref
    - `contract_id` union — Filter by associated contract.
      - ContractId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` ContractId — unresolved $ref
        - `not_contain` ContractId — unresolved $ref
        - `not_eq` ContractId — unresolved $ref
        - `contains` ContractId — unresolved $ref
    - `draft_invoiced` union — Filter by draft invoiced amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` DraftInvoiced — unresolved $ref
        - `contains` DraftInvoiced — unresolved $ref
        - `not_eq` DraftInvoiced — unresolved $ref
        - `not_contain` DraftInvoiced — unresolved $ref
      - DraftInvoiced — unresolved $ref
    - `forecasted_time_usage` union — Filter by forecasted time usage percentage range.
      - ForecastedTimeUsage — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` ForecastedTimeUsage — unresolved $ref
        - `eq` ForecastedTimeUsage — unresolved $ref
        - `contains` ForecastedTimeUsage — unresolved $ref
        - `not_contain` ForecastedTimeUsage — unresolved $ref
    - `invoiced` union — Filter by invoiced amount range.
      - Invoiced — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` Invoiced — unresolved $ref
        - `eq` Invoiced — unresolved $ref
        - `not_contain` Invoiced — unresolved $ref
        - `not_eq` Invoiced — unresolved $ref
    - `recurring_interval_id` union — Filter by recurring contract billing interval.
      - RecurringIntervalId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` RecurringIntervalId — unresolved $ref
        - `not_contain` RecurringIntervalId — unresolved $ref
        - `contains` RecurringIntervalId — unresolved $ref
        - `not_eq` RecurringIntervalId — unresolved $ref
    - `estimated_time` union — Filter by total estimated time amount range.
      - EstimatedTime — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` EstimatedTime — unresolved $ref
        - `contains` EstimatedTime — unresolved $ref
        - `eq` EstimatedTime — unresolved $ref
        - `not_contain` EstimatedTime — unresolved $ref
    - `billable_time` union — Filter by total billable time amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` BillableTime — unresolved $ref
        - `eq` BillableTime — unresolved $ref
        - `not_contain` BillableTime — unresolved $ref
        - `not_eq` BillableTime — unresolved $ref
      - BillableTime — unresolved $ref
    - `designated_approver_id` union — Filter by the designated approver person ID set on the deal (`designated_approver_id`).
      - object — Object form with operator key (eq, not_eq, contains, not_contain).
        - `not_contain` DesignatedApproverId — unresolved $ref
        - `eq` DesignatedApproverId — unresolved $ref
        - `not_eq` DesignatedApproverId — unresolved $ref
        - `contains` DesignatedApproverId — unresolved $ref
      - DesignatedApproverId — unresolved $ref
    - `todo_due_date` union — Filter by next to-do due date.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` TodoDueDate — unresolved $ref
        - `not_contain` TodoDueDate — unresolved $ref
        - `contains` TodoDueDate — unresolved $ref
        - `eq` TodoDueDate — unresolved $ref
      - TodoDueDate — unresolved $ref
    - `budget_total` union — Filter by total budget amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` BudgetTotal — unresolved $ref
        - `not_eq` BudgetTotal — unresolved $ref
        - `contains` BudgetTotal — unresolved $ref
        - `not_contain` BudgetTotal — unresolved $ref
      - BudgetTotal — unresolved $ref
    - `manually_invoiced` union — Filter by manually invoiced amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ManuallyInvoiced — unresolved $ref
        - `eq` ManuallyInvoiced — unresolved $ref
        - `contains` ManuallyInvoiced — unresolved $ref
        - `not_eq` ManuallyInvoiced — unresolved $ref
      - ManuallyInvoiced — unresolved $ref
    - `forecasted_profit` union — Filter by forecasted profit amount range.
      - ForecastedProfit — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ForecastedProfit — unresolved $ref
        - `not_eq` ForecastedProfit — unresolved $ref
        - `eq` ForecastedProfit — unresolved $ref
        - `not_contain` ForecastedProfit — unresolved $ref
    - `budget_usage` union — Filter by budget usage percentage range.
      - BudgetUsage — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` BudgetUsage — unresolved $ref
        - `contains` BudgetUsage — unresolved $ref
        - `not_eq` BudgetUsage — unresolved $ref
        - `eq` BudgetUsage — unresolved $ref
    - `project_type` union — Filter by project type.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ProjectType — unresolved $ref
        - `not_eq` ProjectType — unresolved $ref
        - `eq` ProjectType — unresolved $ref
        - `contains` ProjectType — unresolved $ref
      - ProjectType — unresolved $ref
    - `date` union — Filter by deal start date range (`date`).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` Date — unresolved $ref
        - `contains` Date — unresolved $ref
        - `not_contain` Date — unresolved $ref
        - `eq` Date — unresolved $ref
      - Date — unresolved $ref
    - `estimated_remaining_time` union — Filter by estimated remaining time amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` EstimatedRemainingTime — unresolved $ref
        - `not_contain` EstimatedRemainingTime — unresolved $ref
        - `eq` EstimatedRemainingTime — unresolved $ref
        - `contains` EstimatedRemainingTime — unresolved $ref
      - EstimatedRemainingTime — unresolved $ref
    - `budget_warning` union — Filter by budget warning percentage threshold.
      - BudgetWarning — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` BudgetWarning — unresolved $ref
        - `not_eq` BudgetWarning — unresolved $ref
        - `contains` BudgetWarning — unresolved $ref
        - `eq` BudgetWarning — unresolved $ref
    - `retainer_interval` union — Filter by the deal retainer billing interval (week, two_weeks, month, quarter, half_year, or year).
      - object — Object form with operator key (eq, not_eq, contains, not_contain).
        - `not_contain` RetainerInterval — unresolved $ref
        - `not_eq` RetainerInterval — unresolved $ref
        - `contains` RetainerInterval — unresolved $ref
        - `eq` RetainerInterval — unresolved $ref
      - RetainerInterval — unresolved $ref
    - `time_entry_requirements` union — Filter deals by the fields their time entries are required to include.
      - object
        - `eq` 'note' | 'task' — Match deals whose required time entry fields are exactly this set.
        - `not_eq` 'note' | 'task' — Exclude deals whose required time entry fields are exactly this set.
        - `contains` 'note' | 'task' — Match deals that require all of these time entry fields.
        - `not_contain` 'note' | 'task' — Exclude deals that require all of these time entry fields.
        - `none_of` 'note' | 'task' — Match deals that require none of these time entry fields.
        - `any_of` 'note' | 'task' — Match deals that require at least one of these time entry fields.
      - TimeEntryRequirements — unresolved $ref
    - `created_at` union — Filter by creation date range (`created_at`).
      - CreatedAt — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` CreatedAt — unresolved $ref
        - `contains` CreatedAt — unresolved $ref
        - `not_eq` CreatedAt — unresolved $ref
        - `not_contain` CreatedAt — unresolved $ref
    - `expenses_billable` union — Filter by billable expenses amount range.
      - ExpensesBillable — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` ExpensesBillable — unresolved $ref
        - `not_contain` ExpensesBillable — unresolved $ref
        - `not_eq` ExpensesBillable — unresolved $ref
        - `contains` ExpensesBillable — unresolved $ref
    - `origin_deal_id` union — Filter by the originating deal this budget was created from.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` OriginDealId — unresolved $ref
        - `eq` OriginDealId — unresolved $ref
        - `contains` OriginDealId — unresolved $ref
        - `not_contain` OriginDealId — unresolved $ref
      - OriginDealId — unresolved $ref
    - `recurring` union — Filter by recurring/retainer status.
      - Recurring — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Recurring — unresolved $ref
        - `contains` Recurring — unresolved $ref
        - `not_eq` Recurring — unresolved $ref
        - `not_contain` Recurring — unresolved $ref
    - `invoiced_rate` union — Filter by invoiced rate (invoiced amount per hour) range.
      - InvoicedRate — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` InvoicedRate — unresolved $ref
        - `eq` InvoicedRate — unresolved $ref
        - `not_contain` InvoicedRate — unresolved $ref
        - `contains` InvoicedRate — unresolved $ref
    - `lost_date` union — Filter deals lost on a specific date range (`sales_closed_on` where stage is lost).
      - LostDate — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` LostDate — unresolved $ref
        - `not_contain` LostDate — unresolved $ref
        - `not_eq` LostDate — unresolved $ref
        - `eq` LostDate — unresolved $ref
    - `forecasted_budget_used` union — Filter by forecasted total budget used amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` ForecastedBudgetUsed — unresolved $ref
        - `not_contain` ForecastedBudgetUsed — unresolved $ref
        - `not_eq` ForecastedBudgetUsed — unresolved $ref
        - `contains` ForecastedBudgetUsed — unresolved $ref
      - ForecastedBudgetUsed — unresolved $ref
    - `profit` union — Filter by profit amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` Profit — unresolved $ref
        - `not_eq` Profit — unresolved $ref
        - `eq` Profit — unresolved $ref
        - `contains` Profit — unresolved $ref
      - Profit — unresolved $ref
    - `lost_reason_id` union — Filter by associated lost reason.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` LostReasonId — unresolved $ref
        - `not_contain` LostReasonId — unresolved $ref
        - `contains` LostReasonId — unresolved $ref
        - `not_eq` LostReasonId — unresolved $ref
      - LostReasonId — unresolved $ref
    - `pending_invoicing` union — Filter by pending invoicing amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` PendingInvoicing — unresolved $ref
        - `eq` PendingInvoicing — unresolved $ref
        - `contains` PendingInvoicing — unresolved $ref
        - `not_eq` PendingInvoicing — unresolved $ref
      - PendingInvoicing — unresolved $ref
    - `expense` union — Filter by total expenses amount range.
      - Expense — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` Expense — unresolved $ref
        - `contains` Expense — unresolved $ref
        - `eq` Expense — unresolved $ref
        - `not_eq` Expense — unresolved $ref
    - `full_query` union — Filter by full-text search query.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` FullQuery — unresolved $ref
        - `eq` FullQuery — unresolved $ref
        - `not_contain` FullQuery — unresolved $ref
        - `not_eq` FullQuery — unresolved $ref
      - FullQuery — unresolved $ref
    - `stage_updated_at` union — Filter by date the deal stage was last updated (`sales_status_updated_at`).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` StageUpdatedAt — unresolved $ref
        - `not_contain` StageUpdatedAt — unresolved $ref
        - `not_eq` StageUpdatedAt — unresolved $ref
        - `contains` StageUpdatedAt — unresolved $ref
      - StageUpdatedAt — unresolved $ref
    - `contact_id` union — Filter by associated contact person.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ContactId — unresolved $ref
        - `contains` ContactId — unresolved $ref
        - `not_eq` ContactId — unresolved $ref
        - `eq` ContactId — unresolved $ref
      - ContactId — unresolved $ref
    - `needs_closing` union — Filter to include deals that are past their end date and not yet closed.
      - NeedsClosing — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` NeedsClosing — unresolved $ref
        - `not_eq` NeedsClosing — unresolved $ref
        - `not_contain` NeedsClosing — unresolved $ref
        - `contains` NeedsClosing — unresolved $ref
    - `days_in_current_stage` union — Filter by the number of days the deal has been in its current pipeline stage.
      - DaysInCurrentStage — unresolved $ref
      - object — Object form with operator key (eq, not_eq, contains, not_contain).
        - `not_eq` DaysInCurrentStage — unresolved $ref
        - `not_contain` DaysInCurrentStage — unresolved $ref
        - `contains` DaysInCurrentStage — unresolved $ref
        - `eq` DaysInCurrentStage — unresolved $ref
    - `recurring_starts_on` union — Filter by recurring contract start date range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` RecurringStartsOn — unresolved $ref
        - `contains` RecurringStartsOn — unresolved $ref
        - `eq` RecurringStartsOn — unresolved $ref
        - `not_contain` RecurringStartsOn — unresolved $ref
      - RecurringStartsOn — unresolved $ref
    - `id` union — Filter by deal ID.
      - Id — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
    - `credited` union — Filter by credited amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Credited — unresolved $ref
        - `contains` Credited — unresolved $ref
        - `not_contain` Credited — unresolved $ref
        - `not_eq` Credited — unresolved $ref
      - Credited — unresolved $ref
    - `template` union — Filter to show deal templates only.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Template — unresolved $ref
        - `contains` Template — unresolved $ref
        - `not_eq` Template — unresolved $ref
        - `not_contain` Template — unresolved $ref
      - Template — unresolved $ref
    - `name` union — Filter by deal name (text search).
      - Name — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` Name — unresolved $ref
        - `not_contain` Name — unresolved $ref
        - `not_eq` Name — unresolved $ref
        - `eq` Name — unresolved $ref
    - `next_occurrence_on` union — Filter by next contract occurrence date range.
      - NextOccurrenceOn — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` NextOccurrenceOn — unresolved $ref
        - `contains` NextOccurrenceOn — unresolved $ref
        - `not_eq` NextOccurrenceOn — unresolved $ref
        - `eq` NextOccurrenceOn — unresolved $ref
    - `sales_status_id` union — Filter by sales outcome status (won, lost, open).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` SalesStatusId — unresolved $ref
        - `not_contain` SalesStatusId — unresolved $ref
        - `eq` SalesStatusId — unresolved $ref
        - `not_eq` SalesStatusId — unresolved $ref
      - SalesStatusId — unresolved $ref
    - `end_date` union — Filter by end date range (`end_date`).
      - EndDate — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` EndDate — unresolved $ref
        - `not_eq` EndDate — unresolved $ref
        - `eq` EndDate — unresolved $ref
        - `not_contain` EndDate — unresolved $ref
    - `unapproved_time` union — Filter by unapproved time amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` UnapprovedTime — unresolved $ref
        - `not_contain` UnapprovedTime — unresolved $ref
        - `contains` UnapprovedTime — unresolved $ref
        - `not_eq` UnapprovedTime — unresolved $ref
      - UnapprovedTime — unresolved $ref
    - `deal_status_id` union — Filter by pipeline stage (deal status).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` DealStatusId — unresolved $ref
        - `not_contain` DealStatusId — unresolved $ref
        - `not_eq` DealStatusId — unresolved $ref
        - `contains` DealStatusId — unresolved $ref
      - DealStatusId — unresolved $ref
    - `invoiced_percentage` union — Filter by invoiced percentage range.
      - InvoicedPercentage — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` InvoicedPercentage — unresolved $ref
        - `not_contain` InvoicedPercentage — unresolved $ref
        - `contains` InvoicedPercentage — unresolved $ref
        - `not_eq` InvoicedPercentage — unresolved $ref
    - `sales_closed_on` union — Filter by win/loss date.
      - SalesClosedOn — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` SalesClosedOn — unresolved $ref
        - `not_contain` SalesClosedOn — unresolved $ref
        - `not_eq` SalesClosedOn — unresolved $ref
        - `contains` SalesClosedOn — unresolved $ref
    - `forecasted_margin` union — Filter by forecasted profit margin percentage range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` ForecastedMargin — unresolved $ref
        - `eq` ForecastedMargin — unresolved $ref
        - `contains` ForecastedMargin — unresolved $ref
        - `not_contain` ForecastedMargin — unresolved $ref
      - ForecastedMargin — unresolved $ref
    - `tags` union — Filter by tag.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Tags — unresolved $ref
        - `contains` Tags — unresolved $ref
        - `not_eq` Tags — unresolved $ref
        - `not_contain` Tags — unresolved $ref
      - Tags — unresolved $ref
    - `budgeted_time` union — Filter by total budgeted time amount range.
      - BudgetedTime — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` BudgetedTime — unresolved $ref
        - `not_eq` BudgetedTime — unresolved $ref
        - `not_contain` BudgetedTime — unresolved $ref
        - `contains` BudgetedTime — unresolved $ref
    - `responsible_id` union — Filter by responsible person.
      - ResponsibleId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ResponsibleId — unresolved $ref
        - `contains` ResponsibleId — unresolved $ref
        - `not_eq` ResponsibleId — unresolved $ref
        - `eq` ResponsibleId — unresolved $ref
    - `previous_deal_status_id` union — Filter by the previous pipeline stage the deal was in.
      - PreviousDealStatusId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` PreviousDealStatusId — unresolved $ref
        - `contains` PreviousDealStatusId — unresolved $ref
        - `not_contain` PreviousDealStatusId — unresolved $ref
        - `not_eq` PreviousDealStatusId — unresolved $ref
    - `probability` union — Filter by win probability percentage range.
      - Probability — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Probability — unresolved $ref
        - `contains` Probability — unresolved $ref
        - `not_contain` Probability — unresolved $ref
        - `not_eq` Probability — unresolved $ref
    - `budget_used` union — Filter by amount of budget used.
      - BudgetUsed — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` BudgetUsed — unresolved $ref
        - `contains` BudgetUsed — unresolved $ref
        - `not_contain` BudgetUsed — unresolved $ref
        - `eq` BudgetUsed — unresolved $ref
    - `recurring_ends_on` union — Filter by recurring contract end date range.
      - RecurringEndsOn — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` RecurringEndsOn — unresolved $ref
        - `contains` RecurringEndsOn — unresolved $ref
        - `eq` RecurringEndsOn — unresolved $ref
        - `not_eq` RecurringEndsOn — unresolved $ref
    - `actual_rate` union — Filter by actual hourly rate (revenue per hour worked).
      - ActualRate — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` ActualRate — unresolved $ref
        - `not_contain` ActualRate — unresolved $ref
        - `eq` ActualRate — unresolved $ref
        - `contains` ActualRate — unresolved $ref
    - `previous_probability` union — Filter by the previous win probability percentage range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` PreviousProbability — unresolved $ref
        - `contains` PreviousProbability — unresolved $ref
        - `not_contain` PreviousProbability — unresolved $ref
        - `not_eq` PreviousProbability — unresolved $ref
      - PreviousProbability — unresolved $ref
    - `estimated_cost` union — Filter by estimated cost amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` EstimatedCost — unresolved $ref
        - `eq` EstimatedCost — unresolved $ref
        - `not_eq` EstimatedCost — unresolved $ref
        - `not_contain` EstimatedCost — unresolved $ref
      - EstimatedCost — unresolved $ref
    - `forecasted_revenue` union — Filter by forecasted total revenue amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ForecastedRevenue — unresolved $ref
        - `eq` ForecastedRevenue — unresolved $ref
        - `not_eq` ForecastedRevenue — unresolved $ref
        - `contains` ForecastedRevenue — unresolved $ref
      - ForecastedRevenue — unresolved $ref
    - `query` union — Filter by deal name or reference (full-text search across name and number).
      - Query — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `eq` Query — unresolved $ref
        - `not_contain` Query — unresolved $ref
    - `needs_invoicing` union — Filter to include deals that are closed but have uninvoiced revenue.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
- … truncated; see the full OpenAPI document linked below

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection deal

---

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