---
title: "Get dashboard KPI metrics with period comparison"
method: GET
path: "/v1/admin/reports/dashboard"
tags: ["Admin - Reports"]
---

# Get dashboard KPI metrics with period comparison

`GET /v1/admin/reports/dashboard`

## Query parameters

- `dateStart` string, required
- `dateEnd` string, required
- `compareMode` 'previous_period' | 'previous_month' | 'previous_year'
- `section` 'acquisition' | 'engagement' | 'monetization' | 'funnels'
- `skipCache` boolean

## Response `200`

OK

- DashboardMetricsResponseDto
  - `period` DateRangePairDto, required
    - `dateStart` string, required
    - `dateEnd` string, required
  - `comparisonPeriod` DateRangePairDto, required
    - `dateStart` string, required
    - `dateEnd` string, required
  - `newSignups` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `newSubscribers` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `iapPurchases` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `activeUsers` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `newChatsStarted` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `avgChatLength` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `totalCoinsSpent` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `totalGiftsSent` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `studioImagesTotal` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `studioImagesCustomPrompt` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `signupToMessage` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `signupToContentRequest` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period
  - `chatToGift` MetricWithDeltaDto
    - `current` number, required — Value for the current period
    - `previous` number, required — Value for the comparison period
    - `delta` number, required — Absolute delta (current - previous)
    - `deltaPercent` number, required — Percentage change ((current - previous) / previous * 100)
    - `trend` TrendPointDto[], required — Values for past N periods + current, for sparkline rendering
      - `periodLabel` string, required — Label for this period (e.g. "Mar 25")
      - `value` number, required — Metric value for this period

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)