List RFI Sub Virtual Account

Purpose:
To retrieve a list of virtual accounts created under a business or its sub-users, with support for filtering by account details, currency, creation date, and pagination.

What this endpoint does:

Returns detailed information about virtual accounts, including account numbers, bank details, status, and associated user/sub-user IDs. This endpoint is useful for operational tracking, reconciliation, customer service support, and back-office reporting.

Keynotes:

Supports multiple filters such as accountId, subUserId, currency, and creation time range (startTimestamp, endTimestamp).

Pagination parameters pageNum and pageSize help manage large result sets.

Returned account details may vary depending on currency and jurisdiction — e.g., IBAN and SWIFT codes may not be applicable in all cases.

Account status values typically include:

INIT： Account creation initiated but not yet active

SUCCESS： Account successfully created and active

FAIL： Account creation failed

Useful for listing all virtual accounts associated with a business for audit, support, or transaction routing purposes.

traceId is always returned for troubleshooting and request correlation.

Responses

🟢200OK

application/json

Body

Example

{
    "status": 200,
    "code": null,
    "msg": "OK",
    "data": [
        {
            "accountId": "3100",
            "accountName": "ALBrooks",
            "currency": "MXN",
            "status": "SUCCESS",
            "awaitingRfiTypeList": [
                "SUB_ACCOUNT_RFI_TIER_1"
            ],
            "rfiStatus": "AWAITING_SUBMISSION",
            "rfiInfo": {
                "rfiTierList": [
                    {
                        "tier": "TIER_0",
                        "rfiStatus": "SUBMITTED",
                        "createTime": "2025-12-12T06:51:56.176Z",
                        "answerList": [
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "incorporated_country",
                                "answer": "AF",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "registration_number",
                                "answer": "asfa",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "ubo_name",
                                "answer": "asfasf",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "business_type",
                                "answer": "B2B",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "company_address",
                                "answer": "asfasf",
                                "file": "",
                                "fileList": null
                            }
                        ]
                    },
                    {
                        "tier": "TIER_1",
                        "rfiStatus": "AWAITING_SUBMISSION",
                        "createTime": "2025-12-12T06:53:06.089Z",
                        "answerList": null
                    }
                ]
            }
        },
        {
            "accountId": "3096",
            "accountName": "a21312r1",
            "currency": "NGN",
            "status": "SUCCESS",
            "awaitingRfiTypeList": [
                "SUB_ACCOUNT_RFI_TIER_1",
                "SUB_ACCOUNT_RFI_TIER_2"
            ],
            "rfiStatus": "AWAITING_SUBMISSION",
            "rfiInfo": {
                "rfiTierList": [
                    {
                        "tier": "TIER_0",
                        "rfiStatus": "SUBMITTED",
                        "createTime": "2025-12-12T06:51:56.176Z",
                        "answerList": [
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "incorporated_country",
                                "answer": "AF",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "registration_number",
                                "answer": "asfa",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "ubo_name",
                                "answer": "asfasf",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "business_type",
                                "answer": "B2B",
                                "file": "",
                                "fileList": null
                            },
                            {
                                "bizType": "SUB_ACCOUNT_RFI_TIER_0",
                                "questionId": "company_address",
                                "answer": "asfasf",
                                "file": "",
                                "fileList": null
                            }
                        ]
                    },
                    {
                        "tier": "TIER_1",
                        "rfiStatus": "AWAITING_SUBMISSION",
                        "createTime": "2025-12-12T06:53:06.089Z",
                        "answerList": null
                    },
                    {
                        "tier": "TIER_2",
                        "rfiStatus": "AWAITING_SUBMISSION",
                        "createTime": "2025-12-12T07:00:15.868Z",
                        "answerList": null
                    }
                ]
            }
        }
    ],
    "traceId": "Auto:fe353807e2144242ae87af9ef9e56844",
    "success": true
}

List RFI Sub Virtual Account

Request

Request Code Samples

Responses