Deprecated endpoint
This endpoint will be removed in a future version. Migrate to the recommended replacement.
payments:readUser IDDeprecated. Payment reports have moved to their own surface — use GET /v1/payment-reports (listPaymentReports). This route is retained for existing integrations; it will be removed after a deprecation window.
Retrieve a paginated list of the caller's payment reports (soft-deleted reports excluded),
newest first by default. Same data as GET /v1/payment-reports, in the legacy shape: the list
is under reports, each report's id is _id, and each carries description: PaymentReport.
pageintegerPage number for pagination (defaults to 1).
Default: 1
limitintegerNumber of items per page (defaults to 20, maximum 100).
Default: 20
sort_bystringColumn to sort on. Defaults to created_at.
created_atupdated_atdate_createdfrom_dateto_datestatusgroupgroup_namecosttotal_costtotal_datacurrencycurrency_symbolactiveidsort_directionstringSort direction.
ascdescstart_timedate-timeOnly reports created at or after this time (ISO 8601). Must be sent together with
end_time and must not be after it (400 otherwise). There is no maximum range.
end_timedate-timeOnly reports created at or before this time (ISO 8601). Must be sent together with start_time.
periodstringPredefined creation-time window, used only when start_time/end_time are absent.
With no date parameter at all, reports of every date are listed.
todaylast_24_hoursyesterdaylast_7_daysthis_monthlast_monthlast_30_daysthis_quarterlast_quarterthis_yearlast_yearlast_12_monthsgroupstringFilter by group name (contains match).
coststringFilter by total cost (contains match).
currencystringFilter by currency code.
USDCUSDactivestringFilter by active status.
truefalsetotal_datastringFilter by total data (contains match).
statusstringFilter by report status.
DraftIn-progressCompletedFailedPayment reports retrieved successfully
HTTP status code
Response message
A payment report in the legacy shape. Further stored fields may be present.
Total number of records
Current page number
Number of records per page
Unique request ID for tracking
Example
{
"status_code": 200,
"message": "Success",
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"data": {
"reports": [
{
"_id": "507f1f77bcf86cd799439011",
"description": "PaymentReport",
"community": "507f1f77bcf86cd799439012",
"status": "Completed",
"is_deleted": false,
"date_created": "2026-01-15T12:00:00.000Z",
"from_date": "2026-01-01T00:00:00.000Z",
"to_date": "2026-01-31T23:59:59.000Z",
"group_id": "",
"group_name": "All Groups",
"total_data": "1.5 GB",
"total_cost": "150.00",
"currency_symbol": "USD",
"active": "true",
"report_file": "https://storage.example.com/reports/report-123.csv",
"created_at": "2026-01-15T12:00:00.000Z",
"updated_at": "2026-01-15T12:05:00.000Z"
}
],
"pagination": {
"total": 1,
"page": 1,
"limit": 20
}
}
}Was this page helpful?