Top-up & one-time sales distribution

Returns top-up and one-time purchase counts grouped by plan name for the period. Each item includes a type of topup or one_time.

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, type [topup|one_time]).

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

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "period": "monthly",
        "distribution": [
            {
                "plan_name": "Palm Reading",
                "count": 12,
                "type": "one_time"
            },
            {
                "plan_name": "Topup 50 Messages",
                "count": 8,
                "type": "topup"
            }
        ]
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

Top-up & one-time sales distribution

Request

Request Code Samples

Responses