---
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

---

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