---
title: "Returns report data aggregated by time unit."
method: GET
path: "/report/aggregated/{unit}"
tags: ["Reports"]
---

# Returns report data aggregated by time unit.

`GET /report/aggregated/{unit}`

Returns performance metrics aggregated by the specified time unit (day, hour, month, etc.).
The response is a map of timestamps to metric values, useful for time-series analysis
and trend visualization.

## Date range

Same half-open [from, to) semantics as GET /report — the 'to' date is exclusive.

## Use cases

- Daily performance trends (unit=DAY)
- Hourly granularity for dayparting analysis (unit=HOUR)
- Day-of-week patterns for bid scheduling (unit=DAY_OF_WEEK)
- Hour-of-day patterns for dayparting (unit=HOUR_OF_DAY)

## Path parameters

- `unit` 'DAY' | 'HOUR' | 'MONTH_DATE' | 'MONTH' | 'DAY_OF_WEEK_TIME_OF_DAY' | 'DAY_OF_WEEK' | 'HOUR_OF_DAY', required

## Query parameters

- `filter` string
- `tz` string
- `filter1` string
- `from` string, required
- `filter2` string
- `currency` string
- `to` string
- `filter2Value` string
- `workspaces` string[]
- `conversionTimeMode` 'CONVERSION' | 'VISIT'
- `filter1Value` string

## Response `200`

Time-series report data aggregated by the specified time unit (day, hour, month, etc.).
The data is a map of timestamps to metric values, suitable for charting and trend analysis.

---

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