Skip to main content
Call this endpoint before every funds transfer to verify that the destination account exists and to retrieve the account holder’s name. Confirming the name with your user before moving money prevents misdirected payments — transfers sent to incorrect accounts are difficult to reverse and may require manual intervention from both banks.

​
Endpoint

POST https://baasapi.payrepmfb.com/api/v1/transaction/transfer/api/name_enquiry
The endpoint resolves intra-bank accounts (accounts within Payrep MFB) locally and resolves inter-bank accounts via NIP through the bank provider.

​
Authentication

Pass your bearer JWT in the Authorization header. Obtain a token from Generate Token. 
Authorization: Bearer <access_token>

​
Request body

​
beneficiary_account_number
string
required
The 10-digit account number you want to look up. For intra-bank enquiries this is a Payrep MFB account number. For inter-bank enquiries this is the account number at the external bank.
​
bank_code
string
required
The bank code for the beneficiary’s bank. Use 090823 for intra-bank (Payrep MFB) accounts. For all other Nigerian banks, use the NIP bank code — retrieve the full list from Fetch Banks.
​
source_account_number
string
required
Your Shogun account number initiating the enquiry. This must be a valid, active account belonging to your business.

​
Request example

curl -X POST https://baasapi.payrepmfb.com/api/v1/transaction/transfer/api/name_enquiry \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "beneficiary_account_number": "0123456789",
    "bank_code": "058",
    "source_account_number": "7801234567"
  }'

​
Responses

​
200 — Success

The data object contains the resolved account details. Show the account_name to your user for confirmation before proceeding to funds transfer. 
{
  "status": true,
  "response_code": "00",
  "message": "Name enquiry successful",
  "data": {
    "account_number": "0123456789",
    "account_name": "Jane Doe",
    "bank_code": "058",
    "bank_name": "Guaranty Trust Bank",
    "bvn": "98765432101",
    "kyc": 3
  }
}

​
Error — Account not found

{
  "status": false,
  "response_code": "06",
  "message": "Account not found. Please verify the account number and bank code.",
  "data": null
}

​
Response fields

​
data.account_number
string
The resolved account number, echoed back from the request.
​
data.account_name
string
Full name of the account holder registered with the bank. Display this to your user and require explicit confirmation before initiating the transfer.
​
data.bank_code
string
The bank code associated with the resolved account.
​
data.bank_name
string
Human-readable name of the beneficiary’s bank.
​
data.bvn
string
Bank Verification Number of the account holder. You must pass this value into the bvn field when calling Funds Transfer.
​
data.kyc
integer
KYC level of the account holder. You must pass this value into the kyc field when calling Funds Transfer. Do not hardcode or assume this value.
Store the bvn and kyc values returned by name enquiry — both fields are required when you call Funds Transfer. Always run a fresh name enquiry for each new beneficiary rather than caching results across sessions.