v1

latestOpenAPI 3.1.02026-07-26540161.7 KB

Fetch Account Information by BVN

This endpoint is used for retrieving an account that is belongs to a merchant by BVN

get/profile/virtual-accounts/bvn

Query parameters

bvnstring required

The virtual account BVN

businessstring required

Your business Id

Response

200

successboolean

messagestring

Example response

{
  "success": true,
  "message": "[Notice: Virtual Account endpoint changing soon. Date to be communicated soon] Virtual Accounts fetched successfully",
  "data": [
    {
      "status": "approved",
      "isActive": true,
      "accountNumber": "************",
      "KYCInformation": {
        "firstName": "********",
        "lastName": "***********",
        "email": "********@*****.com"
      },
      "accountInformation": {
        "accountNumber": "************",
        "accountName": "******** ***********",
        "bankName": "GLOBUS BANK",
        "bankCode": "103"
      },
      "isPermanent": true,
      "virtualAccountType": "additional",
      "_id": "***********************",
      "business": "***********************",
      "currency": "NGN",
      "accountType": "individual",
      "entityType": "main_account",
      "currencyType": "fiat",
      "createdAt": "2023-11-27T15:45:02.952Z",
      "updatedAt": "2023-11-27T15:45:02.952Z"
    }
  ]
}