---
title: "Get App Metrics"
method: GET
path: "/api/admin/official-apps/{slug}/metrics"
tags: ["admin-official-apps"]
---

# Get App Metrics

`GET /api/admin/official-apps/{slug}/metrics`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/admin/official-apps/{slug}/metrics`
- Auth: HTTP bearer

Per-app usage + revenue rollup for the admin Usage & Revenue tab.

Reads `ledger_transactions` filtered on `metadata->>'app_slug'=:slug`
and `action_type IN ('app_charge', 'app_charge_refund', 'app_usage')`.
Returns total revenue + charge/refund counts + unique users + a
daily time-series + per-user table + per-unit-kind breakdown.

Period whitelist: 30d | 90d | 365d. Anything else 400s — the
aggregation cost grows linearly so we don't accept arbitrary ranges.

## Path parameters

- `slug` string, required

## Query parameters

- `period` string

## Response `200`

Successful Response

- AdminAppMetricsResponse
  - `period` string, required
  - `revenue_cents` integer, required
  - `charge_count` integer, required
  - `refund_count` integer, required
  - `unique_users` integer, required
  - `series` AdminAppMetricsPoint[], required
    - `date` string, required
    - `charge_cents` integer, required
    - `refund_cents` integer, required
    - `charge_count` integer, required
    - `refund_count` integer, required
  - `by_user` AdminAppMetricsByUser[], required
    - `user_id` string, uuid, required
    - `email` string, nullable
    - `charge_count` integer, required
    - `total_cents` integer, required
    - `refund_count` integer, required
    - `last_action_at` string, date-time, nullable
  - `by_unit_kind` AdminAppMetricsByUnitKind[], required
    - `kind` string, required
    - `count` integer, required
    - `total_cents` integer, required
    - `refund_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)