Premium Bank Account Verification

Premium Bank Account Verification

POST {{baseurl}}/v2/api/identity/ng/premium-bav/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

Premium Bank Account Verification

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

Sample Request

{
    "accountNumber": "2057664202",
    "bankCode": "033",
    "isSubjectConsent": true
}

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

Found Response

{
        "success": true,
        "statusCode": 200,
        "message": "success",
        "data": {
            "id": "67459540289df4cfc5c9d043",
            "parentId": null,
            "status": "found",
            "reason": null,
            "dataValidation": false,
            "selfieValidation": false,
            "isConsent": true,
            "idNumber": "2057664202",
            "businessId": "628b38f03ae28a14f52d4bf7",
            "bankDetails": {
                "accountName": "",
                "accountNumber": "2057664202",
                "accountCurrency": "NAIRA",
                "accountType": "",
                "bankName": null
            },
            "bankCode": "033",
            "address": {
                "city": "",
                "lga": null,
                "state": null,
                "addressLine": "14, SENATE CRESCENT ,UNILAG ESTATE,",
                "town": null
            },
            "bvnNumber": 22144389254,
            "countryOfBirth": "Nigeria", 
            "countryOfIssuance": "",
            "dateOfBirth": "1979-07-13",
            "expiredDate": "",
            "firstName": "DELE  OMONIYI",
            "gender": "Male",
            "lastName": "AWOTUNDE",
            "middleName": "",
            "nationality": "Nigeria",
            "mobile": "8020922840",
            "type": "premiumBav",
            "allValidationPassed": true,
            "requestedAt": "2024-11-26T09:30:41.884Z",
            "requestedById": "628b38f03ae28a5a122d4bf3",
            "country": "NG",
            "createdAt": "2024-11-26T09:30:42.097Z",
            "lastModifiedAt": "2024-11-26T09:30:42.097Z",
            "adverseMediaReport": null,
            "amlReport": null,
            "metadata": {},
            "requestedBy": {
                "firstName": "API",
                "lastName": "User",
                "middleName": "",
                "id": "628b38f03ae28a5a122d4bf3"
            }
        },
        "links": []
    }

Error Response

{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}