Basic Bank Account Verification

Bank Account Verification

POST {{baseurl}}/v2/api/identity/ng/bank-account-number/resolve

Headers

Name	Type	Description
token*	String	API secret token

Request Body

Name	Type	Description
accountNumber*	String	Valid account number
bankCode*	String	Bank code gotten from list of banks
isSubjectConsent*	Boolean	Indicate subject has given consent. Must be true

Bank Account Verification

Bank Account Verification is used to verify the owner of a bank account.

Sample Request

{
    "accountNumber": "1000000000",
    "bankCode": "058",
    "isSubjectConsent": true
}

Note: To get the list of banks in Nigeria, click here

Found Response

{
    "success": true,
    "statusCode": 200,
    "message": "success",
    "data": {
        "id": "6284b245c1f36651d41dc6f3",
        "parentId": null,
        "status": "found",
        "reason": null,
        "dataValidation": false,
        "selfieValidation": false,
        "isConsent": true,
        "idNumber": "1000000000",
        "businessId": "6222a5ed3e7a41c29c031ecc",
        "bankDetails": {
            "accountName": "MICHAEL JOHN DOE",
            "accountNumber": "1000000000",
            "bankName": "Guaranty Trust Bank"
        },
        "type": "bav",
        "requestedAt": "2022-05-18T08:45:58.066Z",
        "requestedById": "6222a5ed3e7a41c29c031ece",
        "country": "NG",
        "createdAt": "2022-05-18T08:45:58.079Z",
        "lastModifiedAt": "2022-05-18T08:45:58.079Z",
        "requestedBy": {
            "firstName": "API",
            "lastName": "User",
            "middleName": "",
            "id": "6222a5ed3e7a41c29c031ece"
        }
    },
    "links": []
}

Not Found Response