Subscription distribution by plan

GET

/api/v1/dashboard/subscriptions

dashboard

Last modified:2026-06-04 22:55:16

Returns active subscription counts grouped by plan name for the period.

Request: Bearer token (admin)

Query: period - one of: last_7_days, monthly, last_3_months, last_6_months, this_year, previous_year (no daily)

Success: 200 - data.period plus data.distribution[] (each: plan_name, count).

Errors: 401 - invalid token | 403 - not admin | 422 - invalid period

Request

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "period": "monthly",
        "distribution": [
            {
                "plan_name": "Seeker",
                "count": 40
            },
            {
                "plan_name": "Sage Monthly",
                "count": 20
            }
        ]
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

Modified at 2026-06-04 22:55:16

User growth time-series

Top-up & one-time sales distribution