---
title: "GET api/integration/v1/financial-reports/budget-health Returns the budget vs actual report with burn-rate analysis. Mirrors BudgetActualReportController.GetBudgetActualReport() — same service call, same request. Requires: Finance role (or higher) + API key with AllowSensitiveData=true (if API-key auth). Columns: Customer, Project, BillingType, BudgetHours, ActualHours, RemainingHours, BurnRateHrsPerDay, ProjectedCompletionDate, WarningLevel, BudgetAmount, ActualCost, BudgetVariance"
method: GET
path: "/api/integration/v1/financial-reports/budget-health"
tags: ["Financial Reports"]
---

# GET api/integration/v1/financial-reports/budget-health Returns the budget vs actual report with burn-rate analysis. Mirrors BudgetActualReportController.GetBudgetActualReport() — same service call, same request. Requires: Finance role (or higher) + API key with AllowSensitiveData=true (if API-key auth). Columns: Customer, Project, BillingType, BudgetHours, ActualHours, RemainingHours, BurnRateHrsPerDay, ProjectedCompletionDate, WarningLevel, BudgetAmount, ActualCost, BudgetVariance

`GET /api/integration/v1/financial-reports/budget-health`

## Request

- Base URL: `https://api.timix.ai`
- URL: `https://api.timix.ai/api/integration/v1/financial-reports/budget-health`
- Auth: API key in header `X-Api-Key`

## Query parameters

- `customerId` string, nullable
- `projectIds` string, nullable
- `startDate` string, date, nullable
- `endDate` string, date, nullable
- `burnRateDays` integer
- `includeTaskBreakdown` boolean

## Response `200`

- BudgetActualReportView
  - `summary` BudgetActualSummary
    - `totalBudgetHours` number
    - `totalActualHours` number
    - `totalRemainingHours` number
    - `hoursVariance` number
    - `hoursVariancePercent` number
    - `totalBudgetAmount` number
    - `totalActualAmount` number
    - `amountVariance` number
    - `averageBurnRatePerWeek` number
    - `projectsOnTrack` integer
    - `projectsAtRisk` integer
    - `projectsOverBudget` integer
    - `projectsUnlimited` integer
  - `customerGroups` BudgetActualCustomerGroup[]
    - `customerId` string
    - `customerName` string
    - `totalBudgetHours` number
    - `totalActualHours` number
    - `projects` BudgetActualProjectView[]
      - `projectId` string
      - `projectName` string
      - `budgetType` string
      - `hasBudget` boolean
      - `tmBudget` BillingTypeBudgetInfo
        - `billingType` string
        - `budgetHours` number
        - `actualHours` number
        - `remainingHours` number
        - `utilizationPercent` number
        - `isAllowed` boolean
      - `fixBudget` BillingTypeBudgetInfo
        - `billingType` string
        - `budgetHours` number
        - `actualHours` number
        - `remainingHours` number
        - `utilizationPercent` number
        - `isAllowed` boolean
      - `ovhBudget` BillingTypeBudgetInfo
        - `billingType` string
        - `budgetHours` number
        - `actualHours` number
        - `remainingHours` number
        - `utilizationPercent` number
        - `isAllowed` boolean
      - `totalBudgetHours` number
      - `totalActualHours` number
      - `hoursVariance` number
      - `utilizationPercent` number
      - `burnRate` BurnRateMetrics
        - `hoursPerWeek` number
        - `hoursPerDay` number
        - `daysInCalculation` integer
        - `projectedCompletionDate` string, date, nullable
        - `daysUntilBudgetExhausted` integer, nullable
        - `projectionConfidence` 'Low' | 'Medium' | 'High'
      - `status` 'OnTrack' | 'AtRisk' | 'OverBudget' | 'Unlimited'
      - `statusExplanation` string
      - `hourlyRate` number
      - `fixedBudgetAmount` number, nullable
      - `isFlagged` boolean
      - `tasks` BudgetActualTaskView[], nullable
        - `taskId` string
        - `taskName` string
        - `actualHours` number
        - `percentOfProject` number
  - `currency` string
  - `generatedAt` string, date-time

---

[API](https://skmtc.dev/timix/apis/timix-ai-integration-api.md) · [All operations](https://skmtc.dev/timix/apis/timix-ai-integration-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timix/apis/timix-ai-integration-api/revisions/ff7f1b6d7479?raw)