Top-up & one-time sales distribution

GET

https://uat-api.hastaai.in/api/v1/dashboard/sales

dashboard

Last modified:2026-08-13 18:45:26

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]).

Query: demo (optional, default false) - fabricated placeholder data, temporary

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://uat-api.hastaai.in/api/v1/dashboard/sales?period=undefined&demo=undefined' \
--header 'Authorization: Bearer <token>'

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

Modified at 2026-08-13 18:45:26

Subscription distribution by plan

Recent activity feed