---
title: "Get Retention Usage Dashboard"
method: GET
path: "/admin/business-dashboards/retention-usage"
tags: ["Admin - Business Dashboards"]
---

# Get Retention Usage Dashboard

`GET /admin/business-dashboards/retention-usage`

## Query parameters

- `weeks` integer

## Response `200`

Successful Response

- RetentionUsageResponse
  - `weeks_analyzed` integer, required
  - `analysis_start_date` string, date-time, required
  - `analysis_end_date` string, date-time, required
  - `wat_current` integer, required
  - `was_current` integer, required
  - `teacher_churn_current` number, required
  - `student_churn_current` number, required
  - `school_churn_current` number, required
  - `teacher_true_churn_current` number, required
  - `student_true_churn_current` number, required
  - `school_true_churn_current` number, required
  - `contract_renewal_rate` number, nullable
  - `weekly_summary` RetentionWeeklyPoint[], required
    - `week` string, required
    - `week_start` string, date-time, required
    - `week_end` string, date-time, required
    - `wat` integer, required
    - `was` integer, required
    - `teacher_churn_rate` number, required
    - `student_churn_rate` number, required
    - `school_churn_rate` number, required
    - `teacher_true_churn_rate` number, required
    - `student_true_churn_rate` number, required
    - `school_true_churn_rate` number, required
  - `grr_nrr_by_month` MonthlyRetentionPoint[], required
    - `month` string, required
    - `month_start` string, date-time, required
    - `month_end` string, date-time, required
    - `base_mrr_eur` number, nullable
    - `retained_mrr_eur` number, nullable
    - `expansion_mrr_eur` number, nullable
    - `grr_pct` number, nullable
    - `nrr_pct` number, nullable

## Other responses

- `422` — Validation Error

---

[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/2a0c1636fd3b?raw)