---
title: "Get Billing Dashboard"
method: GET
path: "/admin/billing/dashboard"
tags: ["admin", "billing"]
---

# Get Billing Dashboard

`GET /admin/billing/dashboard`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/admin/billing/dashboard`
- Auth: OAuth 2
  - Password
  - Token URL: `api/login`

## Query parameters

- `scope` 'open' | 'all'
- `since` string, date, nullable

## Response `200`

Successful Response

- BillingDashboardResponse
  - `scope` 'open' | 'all', required
  - `platform_enabled` boolean, required
  - `platform_enabled_since` string, date-time, nullable, required
  - `flagged_accounts` integer, required
  - `perimeter_accounts` integer, required
  - `since` string, date, required
  - `generated_at` string, date-time, required
  - `revenue` RevenueSummary, required
    - `mrr_cents` integer, required
    - `paying` integer, required
    - `trialing` integer, required
    - `by_plan` object, required
    - `by_payer` object, required
    - `past_due` integer, required
    - `ending` integer, required
  - `free_month` FreeMonthFunnel, required
    - `started` integer, required
    - `running` integer, required
    - `ended` integer, required
    - `converted` integer, required
    - `back_to_discovery` integer, required
    - `conversion_rate` number, nullable
  - `parent_requests` ParentRequestsSummary, required
    - `sent` integer, required
    - `pending` integer, required
    - `paid` integer, required
  - `discovery_usage` DiscoveryUsage, required
    - `active_accounts` integer, required
    - `active_days_p50` integer, nullable
    - `active_days_p90` integer, nullable
    - `ai_requests_per_day_p50` integer, nullable
    - `ai_requests_per_day_p90` integer, nullable
    - `hit_daily_ceiling_accounts` integer, nullable
    - `counted_accounts` integer, required
    - `ai_requests_since` string, date, required
    - `chat_conversations` integer, nullable
    - `exercise_sessions` integer, nullable
    - `copy_reviews` integer, nullable
  - `daily` DomainBillingAdminDashboardDailyPoint[], required
    - `date` string, date, required
    - `free_months_started` integer
    - `subscriptions_created` integer
    - `subscriptions_ended` integer
  - `referrals` ReferralsSummary, required
    - `attached` integer
    - `week_granted` integer
    - `paid` integer
    - `month_granted` integer
    - `blocked_same_card` integer
    - `canceled` integer
    - `capped` integer
    - `weeks_granted` integer
    - `months_granted` integer
    - `credited_cents` integer
    - `top_referrers` TopReferrer[]
      - `user_id` string, required
      - `name` string, nullable
      - `referees` integer, required
      - `rewarded` integer, required
    - `week_to_free_month` WeekToFreeMonth: Among the `referral_week` grants that ended, the share whose account started its free month (a Checkout completed, card in) between the week's start and 3 days after its end: the « continue avec ton mois offert » moment.
      - `ended_weeks` integer
      - `started_free_month` integer
      - `rate` number, nullable

## Other responses

- `422`: Validation Error

## Changes

> 106 revisions in range; 1 not diffed.

- **2026-11-12** `0af74c49ba7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/billing/dashboard/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/de6afcc9656f?raw)
