---
title: "Team analytics and revenue (admin)"
method: GET
path: "/api/admin/teams/{teamId}/analytics"
tags: ["Admin", "Teams"]
---

# Team analytics and revenue (admin)

`GET /api/admin/teams/{teamId}/analytics`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/teams/{teamId}/analytics`
- Auth: HTTP bearer

One payload for the web Analytics and Revenue tabs and native d-sports-engage-native#1245 (Analytics) and #1246 (Revenue). Gate: canAccessTeam (decided 2026-11-11, Option A), also re-checked inside getTeamAnalytics. Owner, editor, viewer and legacy admin members of the team, plus platform admin/superadmin, get 200; outsiders 403 FORBIDDEN; anonymous 401. Web and native hide the Analytics and Revenue rows from editors and viewers in the UI only; do not tighten the server check to owner-only. `period` is 7d, 30d or all; missing or invalid values become 30d (never 400). Totals and trends are lifetime or last 6 months; `period` only sets the comparison window of followerGrowth30d, packGrowth30d and revenueGrowth30d and is echoed as overview.period. Revenue is DSC only; only completed or opened purchases count. There is no pagination and no server export route: web Revenue export is a client-side CSV built from packStats. Response is `Cache-Control: private, no-store`.

## Path parameters

- `teamId` string, required

## Query parameters

- `period` '7d' | '30d' | 'all'

## Response `200`

{ success, data: TeamAnalytics }. Dates are ISO 8601 strings.

- object
  - `success` true, required
  - `data` object, required
    - `overview` object, required
      - `totalPacks` number, required
      - `totalCollectibles` number, required
      - `totalRevenue` number, required
      - `totalFollowers` number, required
      - `totalFans` number, required
      - `totalMembers` number, required
      - `totalCollectors` number, required
      - `avgCollectionSize` number, required
      - `activeDrops` number, required
      - `scheduledDrops` number, required
      - `totalPacksSold` number, required
      - `totalPacksOpened` number, required
      - `packRevenue` number, required
      - `productRevenue` number, required
      - `avgSalePrice` number, required
      - `followerGrowth30d` number, required
      - `packGrowth30d` number, required
      - `revenueGrowth30d` number, required
      - `period` '7d' | '30d' | 'all', required
    - `followerTrend` object[], required
      - `month` string, required
      - `value` number, required
    - `monthlyRevenue` object[], required
      - `month` string, required
      - `revenue` number, required
    - `topPerformers` object[], required
      - `id` string, required
      - `name` string, required
      - `rarity` string, required
      - `sold` number, required
      - `revenue` number, required
      - `priceEach` number, required
    - `revenueByCategory` object[], required
      - `category` string, required
      - `amount` number, required
      - `percentage` number, required
    - `packStats` object[], required
      - `id` string, required
      - `name` string, required
      - `image` string, required
      - `imageThumbhash` string, nullable, required
      - `price` number, required
      - `internalOnly` boolean, required: Internal grant pack. Label Granted when true; Free when price is 0; otherwise paid.
      - `quantity` number, required
      - `sold` number, required
      - `opened` number, required
      - `revenue` number, required
      - `status` 'Scheduled' | 'Active' | 'Paused' | 'Expired' | 'Ended', required
      - `releaseDate` string, date-time, nullable, required
    - `collectibleStats` object[], required
      - `id` string, required
      - `name` string, required
      - `image` string, required
      - `imageThumbhash` string, nullable, required
      - `rarity` string, required
      - `supply` number, required
      - `minted` number, required
      - `distributed` number, required
      - `createdAt` string, date-time, required
    - `recentActivity` object[], required
      - `id` string, required
      - `type` 'pack_purchase' | 'pack_open' | 'product_purchase' | 'team_follow', required
      - `title` string, required
      - `description` string, required
      - `amount` number
      - `currency` string
      - `timestamp` string, date-time, required
    - `rarityDistribution` object[], required
      - `rarity` string, required
      - `count` number, required
      - `percentage` number, required

## Other responses

- `400`: { success: false, error, code: VALIDATION_ERROR } when the team id is missing; also a failure caught inside getTeamAnalytics (for example a database error), which has no code
- `401`: { success: false, error, code: UNAUTHORIZED }
- `403`: { success: false, error, code: FORBIDDEN }
- `500`: { success: false, error, code: INTERNAL_ERROR }

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/teams/:teamId/analytics/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
