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

# Get budget reports

`GET /api/v2/reports/budget_reports`

Retrieve a paginated list of aggregated budget report rows. Supports filtering, grouping, and sorting by budget dimensions and metrics.

## Query parameters

- `sort` string[]
- `group` 'budget' | 'closed_at' | 'company' | 'contract' | 'created_at' | 'custom_fields' | 'date' | 'deal_type' | 'delivered_on' | 'designated_approver' | 'end_date' | 'last_activity_at' | 'month' | 'next_occurrence_on' | 'organization' | 'origin_deal' | 'primary_contact' | 'project' | 'project_type' | 'purchase_order_number' | 'quarter' | 'recurring' | 'recurring_ends_on' | 'recurring_interval' | 'recurring_starts_on' | 'responsible' | 'revenue_distribution_type' | 'status' | 'subsidiary' | 'tracking_type_id' | 'week' | 'year'
- `filter` union — Filter schema for `budget_report` list endpoints — pass a single condition or a logical group.
  - FilterBudgetReport — Available filter parameters for querying aggregated budget report data.
    - `forecasted_time_usage` union — Filter by forecasted time usage percentage (forecasted billable time divided by budgeted time).
      - ForecastedTimeUsage — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ForecastedTimeUsage — unresolved $ref
        - `eq` ForecastedTimeUsage — unresolved $ref
        - `not_eq` ForecastedTimeUsage — unresolved $ref
        - `contains` ForecastedTimeUsage — unresolved $ref
    - `needs_closing` union — Filter to budgets that need closing (overdue or exceeded budget).
      - NeedsClosing — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` NeedsClosing — unresolved $ref
        - `contains` NeedsClosing — unresolved $ref
        - `not_eq` NeedsClosing — unresolved $ref
        - `not_contain` NeedsClosing — unresolved $ref
    - `time_approval` union — Filter by time approval setting (whether time entries require approval on this budget).
      - TimeApproval — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` TimeApproval — unresolved $ref
        - `not_contain` TimeApproval — unresolved $ref
        - `not_eq` TimeApproval — unresolved $ref
        - `contains` TimeApproval — unresolved $ref
    - `forecasted_revenue` union — Filter by forecasted revenue (current revenue plus future revenue).
      - ForecastedRevenue — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ForecastedRevenue — unresolved $ref
        - `not_eq` ForecastedRevenue — unresolved $ref
        - `not_contain` ForecastedRevenue — unresolved $ref
        - `eq` ForecastedRevenue — unresolved $ref
    - `invoiced` union — Filter by invoiced amount range.
      - Invoiced — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` Invoiced — unresolved $ref
        - `contains` Invoiced — unresolved $ref
        - `not_eq` Invoiced — unresolved $ref
        - `eq` Invoiced — unresolved $ref
    - `company_id` union — Filter by the client company associated with the budget.
      - CompanyId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` CompanyId — unresolved $ref
        - `contains` CompanyId — unresolved $ref
        - `not_contain` CompanyId — unresolved $ref
        - `not_eq` CompanyId — unresolved $ref
    - `full_query` union — Full search query string applied to budget names and metadata.
      - FullQuery — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` FullQuery — unresolved $ref
        - `contains` FullQuery — unresolved $ref
        - `eq` FullQuery — unresolved $ref
        - `not_contain` FullQuery — unresolved $ref
    - `delivered_on` union — Filter by delivery date range (delivered_on).
      - DeliveredOn — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` DeliveredOn — unresolved $ref
        - `not_contain` DeliveredOn — unresolved $ref
        - `eq` DeliveredOn — unresolved $ref
        - `contains` DeliveredOn — unresolved $ref
    - `won_date` union — Filter by the sales closed date when the deal status was set to won.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` WonDate — unresolved $ref
        - `not_eq` WonDate — unresolved $ref
        - `eq` WonDate — unresolved $ref
        - `not_contain` WonDate — unresolved $ref
      - WonDate — unresolved $ref
    - `estimated_cost` union — Filter by the estimated cost (based on estimated time and rates).
      - EstimatedCost — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` EstimatedCost — unresolved $ref
        - `not_eq` EstimatedCost — unresolved $ref
        - `eq` EstimatedCost — unresolved $ref
        - `not_contain` EstimatedCost — 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_eq` ExpensesBillable — unresolved $ref
        - `contains` ExpensesBillable — unresolved $ref
        - `not_contain` ExpensesBillable — unresolved $ref
    - `budget_warning` union — Filter by the budget warning threshold percentage. When budget usage exceeds this percentage, the budget is flagged as a warning.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` BudgetWarning — unresolved $ref
        - `not_contain` BudgetWarning — unresolved $ref
        - `contains` BudgetWarning — unresolved $ref
        - `not_eq` BudgetWarning — unresolved $ref
      - BudgetWarning — unresolved $ref
    - `jump_query` union — Jump-to search query for quickly navigating to a budget by name prefix.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` JumpQuery — unresolved $ref
        - `eq` JumpQuery — unresolved $ref
        - `not_contain` JumpQuery — unresolved $ref
        - `not_eq` JumpQuery — unresolved $ref
      - JumpQuery — unresolved $ref
    - `future_budget_used` union — Filter by future budget used amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` FutureBudgetUsed — unresolved $ref
        - `not_eq` FutureBudgetUsed — unresolved $ref
        - `contains` FutureBudgetUsed — unresolved $ref
        - `eq` FutureBudgetUsed — unresolved $ref
      - FutureBudgetUsed — unresolved $ref
    - `query` union — Full-text search query applied to budget name and description.
      - Query — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Query — unresolved $ref
        - `contains` Query — unresolved $ref
        - `not_contain` Query — unresolved $ref
        - `not_eq` Query — unresolved $ref
    - `needs_invoicing` union — Filter to budgets that have uninvoiced billable work ready to invoice.
      - NeedsInvoicing — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` NeedsInvoicing — unresolved $ref
        - `contains` NeedsInvoicing — unresolved $ref
        - `not_eq` NeedsInvoicing — unresolved $ref
        - `not_contain` NeedsInvoicing — unresolved $ref
    - `previous_deal_status_id` union — Filter by the previous deal status (pipeline stage before the current one).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` PreviousDealStatusId — unresolved $ref
        - `not_eq` PreviousDealStatusId — unresolved $ref
        - `not_contain` PreviousDealStatusId — unresolved $ref
        - `contains` PreviousDealStatusId — unresolved $ref
      - PreviousDealStatusId — unresolved $ref
    - `purchase_order_number` union — Filter by purchase order number.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` PurchaseOrderNumber — unresolved $ref
        - `not_contain` PurchaseOrderNumber — unresolved $ref
        - `contains` PurchaseOrderNumber — unresolved $ref
        - `not_eq` PurchaseOrderNumber — unresolved $ref
      - PurchaseOrderNumber — unresolved $ref
    - `deal_type_id` union — Filter by the deal type (e.g. fixed price, hourly, retainer).
      - DealTypeId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` DealTypeId — unresolved $ref
        - `not_eq` DealTypeId — unresolved $ref
        - `contains` DealTypeId — unresolved $ref
        - `eq` DealTypeId — unresolved $ref
    - `number` union — Filter by the budget number (sequential identifier within the organization).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` Number — unresolved $ref
        - `not_eq` Number — unresolved $ref
        - `contains` Number — unresolved $ref
        - `eq` Number — unresolved $ref
      - Number — unresolved $ref
    - `color_id` union — Filter by the display color assigned to the budget.
      - ColorId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` ColorId — unresolved $ref
        - `not_contain` ColorId — unresolved $ref
        - `contains` ColorId — unresolved $ref
        - `eq` ColorId — unresolved $ref
    - `recurring_ends_on` union — Filter by the recurring contract end date range (recurring_ends_on).
      - RecurringEndsOn — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` RecurringEndsOn — unresolved $ref
        - `contains` RecurringEndsOn — unresolved $ref
        - `not_eq` RecurringEndsOn — unresolved $ref
        - `eq` RecurringEndsOn — unresolved $ref
    - `manually_invoiced` union — Filter by manually invoiced amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ManuallyInvoiced — unresolved $ref
        - `eq` ManuallyInvoiced — unresolved $ref
        - `not_eq` ManuallyInvoiced — unresolved $ref
        - `not_contain` ManuallyInvoiced — unresolved $ref
      - ManuallyInvoiced — unresolved $ref
    - `manual_invoicing_status` union — Filter by manual invoicing status (e.g. not_started, in_progress, completed).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ManualInvoicingStatus — unresolved $ref
        - `contains` ManualInvoicingStatus — unresolved $ref
        - `eq` ManualInvoicingStatus — unresolved $ref
        - `not_eq` ManualInvoicingStatus — unresolved $ref
      - ManualInvoicingStatus — unresolved $ref
    - `forecasted_budget_usage` union — Filter by forecasted budget usage percentage (forecasted budget used divided by budget total).
      - ForecastedBudgetUsage — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ForecastedBudgetUsage — unresolved $ref
        - `not_contain` ForecastedBudgetUsage — unresolved $ref
        - `eq` ForecastedBudgetUsage — unresolved $ref
        - `not_eq` ForecastedBudgetUsage — unresolved $ref
    - `contract_id` union — Filter by the associated contract.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` ContractId — unresolved $ref
        - `not_eq` ContractId — unresolved $ref
        - `contains` ContractId — unresolved $ref
        - `eq` ContractId — unresolved $ref
      - ContractId — unresolved $ref
    - `next_occurrence_on` union — Filter by the next recurring occurrence date (next_occurrence_on).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` NextOccurrenceOn — unresolved $ref
        - `eq` NextOccurrenceOn — unresolved $ref
        - `contains` NextOccurrenceOn — unresolved $ref
        - `not_eq` NextOccurrenceOn — unresolved $ref
      - NextOccurrenceOn — unresolved $ref
    - `projected_revenue` union — Filter by projected revenue amount range.
      - ProjectedRevenue — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` ProjectedRevenue — unresolved $ref
        - `eq` ProjectedRevenue — unresolved $ref
        - `not_contain` ProjectedRevenue — unresolved $ref
        - `contains` ProjectedRevenue — unresolved $ref
    - `closed_at` union — Filter by budget close date range (closed_at).
      - ClosedAt — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` ClosedAt — unresolved $ref
        - `contains` ClosedAt — unresolved $ref
        - `not_eq` ClosedAt — unresolved $ref
        - `not_contain` ClosedAt — unresolved $ref
    - `worked_time` union — Filter by total time logged on this budget, in minutes.
      - WorkedTime — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` WorkedTime — unresolved $ref
        - `eq` WorkedTime — unresolved $ref
        - `not_eq` WorkedTime — unresolved $ref
        - `contains` WorkedTime — unresolved $ref
    - `fuzzy_dates` union — Filter using relative date expressions (e.g. this_week, last_month) for date fields.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` FuzzyDates — unresolved $ref
        - `not_contain` FuzzyDates — unresolved $ref
        - `not_eq` FuzzyDates — unresolved $ref
        - `eq` FuzzyDates — unresolved $ref
      - FuzzyDates — unresolved $ref
    - `pending_invoicing` union — Filter by the amount pending invoicing (billable work not yet invoiced).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` PendingInvoicing — unresolved $ref
        - `contains` PendingInvoicing — unresolved $ref
        - `not_contain` PendingInvoicing — unresolved $ref
        - `not_eq` PendingInvoicing — unresolved $ref
      - PendingInvoicing — unresolved $ref
    - `subscriber_id` union — Filter to budgets where the specified person is a subscriber.
      - SubscriberId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` SubscriberId — unresolved $ref
        - `contains` SubscriberId — unresolved $ref
        - `eq` SubscriberId — unresolved $ref
        - `not_eq` SubscriberId — unresolved $ref
    - `previous_or_current_deal_status_id` union — Filter by deals that are currently or were previously in the specified deal status.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` PreviousOrCurrentDealStatusId — unresolved $ref
        - `contains` PreviousOrCurrentDealStatusId — unresolved $ref
        - `not_contain` PreviousOrCurrentDealStatusId — unresolved $ref
        - `eq` PreviousOrCurrentDealStatusId — unresolved $ref
      - PreviousOrCurrentDealStatusId — unresolved $ref
    - `future_cost` union — Filter by future cost amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` FutureCost — unresolved $ref
        - `contains` FutureCost — unresolved $ref
        - `not_eq` FutureCost — unresolved $ref
        - `eq` FutureCost — unresolved $ref
      - FutureCost — unresolved $ref
    - `profit_margin` union — Filter by profit margin percentage (profit divided by revenue).
      - ProfitMargin — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ProfitMargin — unresolved $ref
        - `not_contain` ProfitMargin — unresolved $ref
        - `eq` ProfitMargin — unresolved $ref
        - `not_eq` ProfitMargin — unresolved $ref
    - `profit` union — Filter by total profit (revenue minus cost) on this budget.
      - Profit — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` Profit — unresolved $ref
        - `not_eq` Profit — unresolved $ref
        - `not_contain` Profit — unresolved $ref
        - `eq` Profit — unresolved $ref
    - `future_booked_time` union — Filter by future booked time from scheduled bookings, in minutes.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` FutureBookedTime — unresolved $ref
        - `not_contain` FutureBookedTime — unresolved $ref
        - `eq` FutureBookedTime — unresolved $ref
        - `contains` FutureBookedTime — unresolved $ref
      - FutureBookedTime — unresolved $ref
    - `status_id` union — Filter by the current deal status (pipeline stage).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` StatusId — unresolved $ref
        - `not_contain` StatusId — unresolved $ref
        - `eq` StatusId — unresolved $ref
        - `contains` StatusId — unresolved $ref
      - StatusId — unresolved $ref
    - `previous_probability` union — Filter by the previous deal win probability percentage range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` PreviousProbability — unresolved $ref
        - `contains` PreviousProbability — unresolved $ref
        - `not_eq` PreviousProbability — unresolved $ref
        - `not_contain` PreviousProbability — unresolved $ref
      - PreviousProbability — unresolved $ref
    - `stage_status_id` union — Filter by the current pipeline stage (stage status).
      - StageStatusId — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` StageStatusId — unresolved $ref
        - `not_eq` StageStatusId — unresolved $ref
        - `eq` StageStatusId — unresolved $ref
        - `contains` StageStatusId — unresolved $ref
    - `id` union — Filter by budget ID.
      - Id — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
    - `invoiced_rate` union — Filter by the effective invoiced rate (invoiced amount divided by worked time).
      - 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
      - InvoicedRate — unresolved $ref
    - `billable_time` union — Filter by total billable time logged on this budget, in minutes.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` BillableTime — unresolved $ref
        - `not_eq` BillableTime — unresolved $ref
        - `contains` BillableTime — unresolved $ref
        - `not_contain` BillableTime — unresolved $ref
      - BillableTime — unresolved $ref
    - `forecasted_margin` union — Filter by forecasted profit margin percentage range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ForecastedMargin — unresolved $ref
        - `not_contain` ForecastedMargin — unresolved $ref
        - `eq` ForecastedMargin — unresolved $ref
        - `not_eq` ForecastedMargin — unresolved $ref
      - ForecastedMargin — unresolved $ref
    - `sales_closed_on` union — Filter by the date the budget was closed in sales (won or lost).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` SalesClosedOn — unresolved $ref
        - `eq` SalesClosedOn — unresolved $ref
        - `not_contain` SalesClosedOn — unresolved $ref
        - `contains` SalesClosedOn — unresolved $ref
      - SalesClosedOn — unresolved $ref
    - `fuzzy_people` union — Filter using fuzzy person references (e.g. me, my_team) for person fields.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` FuzzyPeople — unresolved $ref
        - `contains` FuzzyPeople — unresolved $ref
        - `eq` FuzzyPeople — unresolved $ref
        - `not_contain` FuzzyPeople — unresolved $ref
      - FuzzyPeople — unresolved $ref
    - `lost_at` union — Filter by the date the deal was marked as lost (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
    - `contact_id` union — Filter by the contact person associated with the budget.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ContactId — unresolved $ref
        - `not_contain` ContactId — unresolved $ref
        - `eq` ContactId — unresolved $ref
        - `not_eq` ContactId — unresolved $ref
      - ContactId — unresolved $ref
    - `project_id` union — Filter by the associated project.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
        - `eq` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
      - ProjectId — unresolved $ref
    - `won_at` union — Filter by the date the deal was marked as won (won_at).
      - WonAt — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` WonAt — unresolved $ref
        - `eq` WonAt — unresolved $ref
        - `contains` WonAt — unresolved $ref
        - `not_eq` WonAt — 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`.
        - `contains` OriginDealId — unresolved $ref
        - `eq` OriginDealId — unresolved $ref
        - `not_contain` OriginDealId — unresolved $ref
        - `not_eq` OriginDealId — unresolved $ref
      - OriginDealId — unresolved $ref
    - `retainer_interval` union — Filter by the budget 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
        - `eq` RetainerInterval — unresolved $ref
        - `contains` RetainerInterval — unresolved $ref
      - RetainerInterval — unresolved $ref
    - `project_type` union — Filter by project type (billable or overhead).
      - ProjectType — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` ProjectType — unresolved $ref
        - `not_eq` ProjectType — unresolved $ref
        - `eq` ProjectType — unresolved $ref
        - `not_contain` ProjectType — unresolved $ref
    - `revenue` union — Filter by revenue amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` Revenue — unresolved $ref
        - `eq` Revenue — unresolved $ref
        - `not_eq` Revenue — unresolved $ref
        - `not_contain` Revenue — unresolved $ref
      - Revenue — unresolved $ref
    - `sales_status_id` union — Filter by the sales deal status (opportunity pipeline stage).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` SalesStatusId — unresolved $ref
        - `eq` SalesStatusId — unresolved $ref
        - `contains` SalesStatusId — unresolved $ref
        - `not_eq` SalesStatusId — unresolved $ref
      - SalesStatusId — unresolved $ref
    - `sales_closed_at` union — Filter by sales close date range (sales_closed_at).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_contain` SalesClosedAt — unresolved $ref
        - `eq` SalesClosedAt — unresolved $ref
        - `not_eq` SalesClosedAt — unresolved $ref
        - `contains` SalesClosedAt — unresolved $ref
      - SalesClosedAt — unresolved $ref
    - `accessible_by_person` union — Filter to budgets accessible by the specified person.
      - AccessibleByPerson — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` AccessibleByPerson — unresolved $ref
        - `contains` AccessibleByPerson — unresolved $ref
        - `not_contain` AccessibleByPerson — unresolved $ref
        - `eq` AccessibleByPerson — unresolved $ref
    - `responsible_id` union — Filter by the person responsible for the budget.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` ResponsibleId — unresolved $ref
        - `contains` ResponsibleId — unresolved $ref
        - `not_eq` ResponsibleId — unresolved $ref
        - `not_contain` ResponsibleId — unresolved $ref
      - ResponsibleId — unresolved $ref
    - `recurring` union — Filter to recurring budgets only (generated from contracts).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` Recurring — unresolved $ref
        - `eq` Recurring — unresolved $ref
        - `contains` Recurring — unresolved $ref
        - `not_contain` Recurring — unresolved $ref
      - Recurring — unresolved $ref
    - `creator_id` union — Filter by the person who created the budget.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` CreatorId — unresolved $ref
        - `not_contain` CreatorId — unresolved $ref
        - `not_eq` CreatorId — unresolved $ref
        - `eq` CreatorId — unresolved $ref
      - CreatorId — unresolved $ref
    - `estimated_time` union — Filter by the total estimated time on this budget, in minutes.
      - EstimatedTime — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` EstimatedTime — unresolved $ref
        - `not_contain` EstimatedTime — unresolved $ref
        - `contains` EstimatedTime — unresolved $ref
        - `eq` EstimatedTime — unresolved $ref
    - `budget_usage` union — Filter by the budget usage percentage (budget used divided by budget total).
      - BudgetUsage — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` BudgetUsage — unresolved $ref
        - `not_contain` BudgetUsage — unresolved $ref
        - `contains` BudgetUsage — unresolved $ref
        - `eq` BudgetUsage — unresolved $ref
    - `work_cost` union — Filter by work cost amount range.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` WorkCost — unresolved $ref
        - `not_contain` WorkCost — unresolved $ref
        - `not_eq` WorkCost — unresolved $ref
        - `contains` WorkCost — unresolved $ref
      - WorkCost — unresolved $ref
    - `tracking_type_id` union — Filter by time tracking type.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` TrackingTypeId — unresolved $ref
        - `contains` TrackingTypeId — unresolved $ref
        - `not_contain` TrackingTypeId — unresolved $ref
        - `eq` TrackingTypeId — unresolved $ref
      - TrackingTypeId — unresolved $ref
    - `lost_date` union — Filter by the sales closed date when the deal status was set to lost.
      - LostDate — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` LostDate — unresolved $ref
        - `contains` LostDate — unresolved $ref
        - `not_contain` LostDate — unresolved $ref
        - `eq` LostDate — unresolved $ref
    - `future_revenue` union — Filter by future revenue amount range.
      - FutureRevenue — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` FutureRevenue — unresolved $ref
        - `eq` FutureRevenue — unresolved $ref
        - `not_eq` FutureRevenue — unresolved $ref
        - `not_contain` FutureRevenue — unresolved $ref
    - `date` union — Filter by the report date (used to scope the time range of aggregated metrics).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `contains` Date — unresolved $ref
        - `eq` Date — unresolved $ref
        - `not_contain` Date — unresolved $ref
        - `not_eq` Date — unresolved $ref
      - Date — unresolved $ref
    - `tags` union — Filter by tag.
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` Tags — unresolved $ref
        - `not_contain` Tags — unresolved $ref
        - `contains` Tags — unresolved $ref
        - `not_eq` Tags — unresolved $ref
      - Tags — unresolved $ref
    - `end_date` union — Filter by budget end date range (end_date).
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `not_eq` EndDate — unresolved $ref
        - `not_contain` EndDate — unresolved $ref
        - `eq` EndDate — unresolved $ref
        - `contains` EndDate — unresolved $ref
      - EndDate — unresolved $ref
    - `revenue_distribution_type` union — Filter by revenue distribution type (e.g. time_and_materials, fixed_price, as_invoiced).
      - RevenueDistributionType — unresolved $ref
      - object — Operator object — supports `eq`, `not_eq`, `contains`, `not_contain`.
        - `eq` RevenueDistributionType — unresolved $ref
- … truncated; see the full OpenAPI document linked below

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection budget report

---

[API](https://skmtc.dev/productive/apis/api-documentation.md) · [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/bbf5057edf0d/schema)