Use this endpoint to retrieve a paginated list of all accounts belonging to your business. You can filter results by account type, status, pool account number, or availability to narrow down the view. This is useful for building account management dashboards or programmatically auditing your account portfolio.
Endpoint POST /api/v1/account/web/fetch_customer_accounts
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. Omit the body entirely to retrieve all accounts without filtering.
An object containing account-level filter criteria. Filter by a specific 10-digit account number.
Filter by account name. Maximum 255 characters.
Filter by type: normal, virtual, current, or savings.
Filter by status: active, inactive, blocked, closed, or pending.
Filter virtual accounts by their linked pool account number. Maximum 10 characters.
Filter by whether the account is currently available for a new collection.
Number of accounts to return per page. Defaults to 20.
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.
Maximum total number of records to return.
Example request curl --request POST \ --url https://baasapi.payrepmfb.com/api/v1/account/web/fetch_customer_accounts \ --header "Authorization: Bearer <access_token>" \ --header "Content-Type: application/json" \ --data '{ "filters": { "account_type": "virtual", "status": "active" }, "limit": 20 }'
Response A successful request returns an array of account objects.
{ "status" : true , "response_code" : "00" , "message" : "Accounts fetched successfully" , "data" : [ { "account_number" : "7801234567" , "account_name" : "Main Pool Account" , "account_type" : "pool" , "status" : "active" , "balance" : "1500000.000000000" , "last_balance_update" : "2026-02-25T10:30:00Z" , "is_available" : true , "pool_account_number" : null }, { "account_number" : "7801234568" , "account_name" : "Lagos Branch Sales" , "account_type" : "current" , "status" : "active" , "balance" : "250000.000000000" , "last_balance_update" : "2026-02-25T12:00:00Z" , "is_available" : true , "pool_account_number" : "7801234567" } ] }
Error codes Response code Meaning 41Customer not found — your session credentials are invalid.
