---
title: "Get subscription analytics"
method: GET
path: "/api/analytics/subscriptions"
tags: ["Analytics"]
---

# Get subscription analytics

`GET /api/analytics/subscriptions`

Retrieve subscription metrics including active count, churn rate, new subscriptions, and status distribution.

## Query parameters

- `dateFrom` string
- `dateTo` string
- `currency` string
- `groupBy` 'day' | 'week' | 'month'

## Response `200`

Subscription metrics and trends

- SubscriptionAnalyticsResponse
  - `total` number, required
  - `active` number, required
  - `canceled` number, required
  - `trialing` number, required
  - `paused` number, required
  - `newSubscriptions` number, required
  - `churnRate` string, required — Churn rate percentage
  - `retentionRate` string, required — Retention rate percentage

## Changes

- **2026-02-16** `0e449a4e0dc8` — 1 info
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/novabilling/apis/novabilling-api/changes/api/analytics/subscriptions/get.md)

---

[API](https://skmtc.dev/novabilling/apis/novabilling-api.md) · [All operations](https://skmtc.dev/novabilling/apis/novabilling-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/novabilling/novabilling-api/revisions/0e449a4e0dc8/schema)