---
title: "GET api/integration/v1/financial-reports/revenue Returns the revenue analysis report for the authenticated org. Mirrors ReportsController.GetRevenueAnalysis() — same service call, same request construction, same default window (trailing 6 months). Requires: Finance role (or higher) + API key with AllowSensitiveData=true (if API-key auth). Columns: Period, GroupDimension, GroupValue, BillingType, BillableHours, Revenue, InternalCost, GrossProfit, GrossMarginPct, EffectiveBillRate"
method: GET
path: "/api/integration/v1/financial-reports/revenue"
tags: ["Financial Reports"]
---

# GET api/integration/v1/financial-reports/revenue Returns the revenue analysis report for the authenticated org. Mirrors ReportsController.GetRevenueAnalysis() — same service call, same request construction, same default window (trailing 6 months). Requires: Finance role (or higher) + API key with AllowSensitiveData=true (if API-key auth). Columns: Period, GroupDimension, GroupValue, BillingType, BillableHours, Revenue, InternalCost, GrossProfit, GrossMarginPct, EffectiveBillRate

`GET /api/integration/v1/financial-reports/revenue`

## Request

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

## Query parameters

- `startDate` string, date, nullable
- `endDate` string, date, nullable
- `groupBy` 'Customer' | 'Project' | 'BillingType' | 'Month'
- `customerIds` string, nullable
- `projectIds` string, nullable
- `billingType` 'Unknown' | 'Fix' | 'TM' | 'OVH' | 'MIXED'

## Response `200`

- RevenueAnalysisReportView
  - `startDate` string, date
  - `endDate` string, date
  - `groupBy` 'Customer' | 'Project' | 'BillingType' | 'Month'
  - `summary` RevenueAnalysisSummary
    - `totalRevenue` number
    - `invoicedRevenue` number
    - `totalCost` number
    - `grossProfit` number
    - `grossMargin` number
    - `effectiveBillRate` number
    - `billableHours` number
    - `totalHours` number
    - `currency` string
  - `groups` RevenueAnalysisGroupView[]
    - `groupId` string
    - `groupLabel` string
    - `billableHours` number
    - `totalHours` number
    - `revenue` number
    - `invoicedRevenue` number
    - `cost` number
    - `profit` number
    - `margin` number
    - `effRate` number
  - `revenueByMonth` RevenueByMonthPoint[]
    - `year` integer
    - `month` integer
    - `label` string
    - `revenue` number
    - `invoicedRevenue` number
    - `cost` number
    - `profit` 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)