---
title: "Retrieves aggregated expense statistics for a date range, with optional grouping by up to three dimensions (e.g. Category, Project, User, Month). Requires ExpenseDateFrom and ExpenseDateTo."
method: GET
path: "/api/ExpenseSummary"
tags: ["ExpenseSummary"]
---

# Retrieves aggregated expense statistics for a date range, with optional grouping by up to three dimensions (e.g. Category, Project, User, Month). Requires ExpenseDateFrom and ExpenseDateTo.

`GET /api/ExpenseSummary`

## Query parameters

- `model.groupBy` string[]
- `model.expenseDateFrom` string, date-time
- `model.expenseDateTo` string, date-time
- `model.userID` integer[]
- `model.projectID` integer

## Response `200`

Returns aggregated expense totals with optional grouping.

- ExpenseSummaryResult — Aggregated expense statistics for a date range, including total amounts and grouped sub-totals.
  - `ExpenseDateFrom` string, date-time — Start date for the summary period.
  - `ExpenseDateTo` string, date-time — End date for the summary period.
  - `TotalAmount` number, double — Total expense amount for the period.
  - `UserID` integer[] — Optional user ID(s) the summary is filtered by.
  - `GroupingLevels` string[] — The grouping dimensions applied to the summary data.
  - `GroupData` ExpenseSummaryGroup[] — Grouped summary data, nested by grouping levels.
    - `GroupID` string — Identifier for this group (e.g. project ID, user ID, month number).
    - `GroupName` string — Display name for this group (e.g. project name, user name, month name).
    - `TotalAmount` number, double — Total expense amount for this group.
    - `GroupData` ExpenseSummaryGroup[] — Nested group data for the next grouping level, if applicable.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/avaza/apis/avaza-api-documentation.md) · [All operations](https://skmtc.net/avaza/apis/avaza-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avaza/avaza-api-documentation/versions/1eeadf750514/schema)