ورود | ثبت نام
- FA
- EN
Receive chart data of payments and transactions in the given date range and filters.
| Permission | Description |
|---|---|
payments.view_all | View data of all payments in the system |
payments.view_own | View only own payment data |
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| type | string | No | See available types. Comma-separated | "wallet,subscription" |
| payable_type | string | No | Filter by payable type(s), comma-separated | "gym,plan" |
| payable_id | int | No | Filter by payable ID(s), comma-separated | "1,2,3" |
| user_id | int | No | Filter by user ID(s), comma-separated | "10,20" |
| is_done | bool | No | Filter by completion status | true |
| start_date | string | No | Start of date range (YYYY-MM-DD) | "2024-01-01" |
| end_date | string | No | End of date range (YYYY-MM-DD) | "2024-01-31" |
| min_amount | number | No | Minimum amount | 100 |
| max_amount | number | No | Maximum amount | 1000 |
| description | string | No | Search in description | "membership" |
| group_by | string | No | How to group the chart data: "day", "week", "month" | "day" |
GET /api/v1/payments/data/chart?user_id=10
Authorization: Bearer {token}
Returns chart data for each type of payment record.
{
"labels": ["2025-01", "2025-02", "2025-03"],
"data": {
"deposit": [1200, 800, 1000],
"income": [400, 600, 750],
"purchase": [300, 500, 450],
"commission": [50, 60, 80],
"withdrawal": [200, 150, 300]
}
}
Normal users can use this as a overall payment report for their own account, and admins can use it as the whole system cash flow report.
| Status | Description | Reference |
|---|---|---|
| 401 | Unauthorized | Authentication error |
