User growth time-series

GET

/api/v1/dashboard/user-growth

dashboard

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

Returns new-user signup counts bucketed by the chosen period.

Request: Bearer token (admin)

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

Success: 200 - daily returns a single count for today; ranges return daily or monthly buckets

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": "last_7_days",
        "series": [
            {
                "label": "2026-05-23",
                "count": 30
            },
            {
                "label": "2026-05-24",
                "count": 41
            }
        ]
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

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

Dashboard overview stats

Subscription distribution by plan