Use with the BVN Number or the Mobile Number

​
Request

[GET]
{{baseUrl}}/api/v1/kyc/accounts
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringpublic secret key

​
Query parameter

ParameterTypeDescriptionRequired
mobile_numberstringMobile Number of Customerrequired
bvnstringBVN Number of Customerrequired

​
Sample response

Response
{
    "entity": {
        "banks": [
            {
                "accountDescription": "221****095",
                "bankName": "Zenith Bank",
                "bankCode": "057",
                "mobile_number": "2348137877844"
            },
            {
                "account_description": "999****260",
                "bankName": "Access Bank Nigeria Plc",
                "bankCode": "044",
                "mobile_number": "2348137877844"
            },
            {
                "accountDescription": "131****617",
                "bankName": "Access Bank Nigeria Plc",
                "bankCode": "044",
                "mobile_number": "2348137877844"
            },
            {
                "accountDescription": "304XXXX407",
                "bankName": "FBN",
                "bankCode": "011",
                "mobile_number": "2348137877844"
            }
        ],
      "bvn": "22271325557",
      "mobile_number": "08137877844"
    }

}

​
Test Credentials for Sandbox

Kindly use this Test details in sandbox Environment

mobile_number = 08137877844

BVN = 22271325557

Use with the BVN Number or the Mobile Number

​
Request

[GET]
{{baseUrl}}/api/v1/kyc/accounts
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringpublic secret key

​
Query parameter

ParameterTypeDescriptionRequired
mobile_numberstringMobile Number of Customerrequired
bvnstringBVN Number of Customerrequired

​
Sample response

Response
{
    "entity": {
        "banks": [
            {
                "accountDescription": "221****095",
                "bankName": "Zenith Bank",
                "bankCode": "057",
                "mobile_number": "2348137877844"
            },
            {
                "account_description": "999****260",
                "bankName": "Access Bank Nigeria Plc",
                "bankCode": "044",
                "mobile_number": "2348137877844"
            },
            {
                "accountDescription": "131****617",
                "bankName": "Access Bank Nigeria Plc",
                "bankCode": "044",
                "mobile_number": "2348137877844"
            },
            {
                "accountDescription": "304XXXX407",
                "bankName": "FBN",
                "bankCode": "011",
                "mobile_number": "2348137877844"
            }
        ],
      "bvn": "22271325557",
      "mobile_number": "08137877844"
    }

}

​
Test Credentials for Sandbox

Kindly use this Test details in sandbox Environment

mobile_number = 08137877844

BVN = 22271325557