API reference / Name enquiry
v1Get support
Accounts / Name enquiry

Name enquiry

POST/api/v1/accounts/name-enquiry
🔒 Requires Bearer token

Resolve an account name for a supplied account number and destination financial institution code before creating a payout.

Body parameters
FieldTypeReqDescription
accountNumberstring●The beneficiary account number to validate.
financialInstitutionCodestring●The destination bank or financial institution code.
Returns

The resolved account details, response code, currency code, and a response description for the enquiry. See the example response in the panel.

Sandbox only

Try this endpoint

Requests are proxied through the docs app and never sent to live.
ResponseWaiting for request
Send a sandbox request to see the response here.
curl https://api.dev.mightypay.io/api/v1/accounts/name-enquiry \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"accountNumber": "0247639185",
"financialInstitutionCode": "030100"
}'
REQUEST
RESPONSE200 OK
{
"accountNumber": "0247639185",
"financialInstitutionCode": "030100",
"accountName": "Ama Kwarteng",
"responseCode": "00",
"currencyCode": "GHS",
"responseDescription": "Account resolved successfully"
}