Use this endpoint to retrieve collection (inbound credit) aggregates for every account in your business. The response groups data by account and includes the total number of collections and their combined value. You can filter by account type, status, pool account, or date range to focus on a specific segment of your portfolio.
Endpoint POST /api/v1/account/web/fetch_account_collections
Authentication Include your JWT access token in the Authorization header.
Authorization: Bearer <access_token>
Obtain a token via POST /auth/web/login .
Request body All body parameters are optional.
Filter by account type. Allowed values: normal, virtual, current, savings.
Filter results to a specific 10-digit account number.
Filter by account status. Allowed values: active, inactive, blocked, closed, pending.
Filter virtual accounts by their linked pool account number. Maximum 10 characters.
Scope collections to a single date (YYYY-MM-DD).
Start of a date range for collection filtering (YYYY-MM-DD).
End of a date range for collection filtering (YYYY-MM-DD).
Maximum number of account records to return per page.
Pagination cursor — the created_at timestamp (ISO 8601) of the last item from the previous page.
Pagination cursor — the UUID id of the last item from the previous page.
Example request curl --request POST \ --url https://baasapi.payrepmfb.com/api/v1/account/web/fetch_account_collections \ --header "Authorization: Bearer <access_token>" \ --header "Content-Type: application/json" \ --data '{ "account_type": "virtual", "start_date": "2026-01-01", "end_date": "2026-04-28" }'
Response A successful request returns an array of account collection aggregate objects.
true when the request succeeds.
Array of account collection objects, one per account. Show Account collection object fields
The 10-digit account number.
The human-readable account label.
Type of account: normal, virtual, current, or savings.
Classification: primary or secondary.
Current account balance as a decimal string.
Number of inbound credit transactions for this account.
Combined value of all collections for this account, as a decimal string.
ISO 8601 timestamp of the most recent collection event. null if no collections have occurred.
ISO 8601 timestamp when the account was created.
{ "status" : true , "response_code" : "00" , "message" : "Account collections fetched successfully" , "data" : [ { "account_number" : "7801234567" , "account_name" : "Main Pool Account" , "account_type" : "pool" , "account_class" : "primary" , "status" : "active" , "balance" : "1500000.000000000" , "last_balance_update" : "2026-02-25T10:30:00Z" , "total_collections" : 142 , "total_collection_amount" : "5200000.00" , "last_transaction_date" : "2026-02-25T14:22:00Z" , "created_at" : "2026-01-15T09:00:00Z" } ] }
Error codes Response code Meaning 41Customer not found — your session credentials are invalid.
