Docs: POST /account/resolve

Resolve a bank account

Resolve account

Looks up the registered account name for a given account number and bank code. Requires an API key. Rate limited to 20 requests per key per 24 hours.

POST/public/account/resolve

Header

FieldTypeRequiredDescription
x-api-keystringtrueYour Myhappr API key. Get it from your Developer Dashboard.
Myhappr API Key drawer showing where to find your key

Request body

FieldTypeRequiredDescription
accountNumberstringtrue10-digit bank account number (NUBAN format for Nigerian banks).
bankCodestringtrueBank code from GET /public/banks. Example: 044 for Access Bank.

Request

curl
curl -X POST "https://api.myhappr.com/api/v1/public/account/resolve" \
  -H "Content-Type: application/json" \
  -H "x-api-key: mhk_your_api_key_here" \
  -d '{
    "accountNumber": "0123456789",
    "bankCode": "044"
  }'

Response

200 OK
{
  "message": "Account resolved successfully",
  "data": {
    "bankCode": "044",
    "accountNumber": "0123456789",
    "accountName": "John Doe"
  }
 }

Try it out

Collect and confirm the account details

Send a ten-digit Nigerian account number and the matching bank code in a JSON request body. Preserve the account number as text, including any leading zero. Obtain the bank code from the bank-list endpoint rather than asking someone to guess it. The successful response includes the registered account name. Show that name to the user for confirmation before proceeding with your own workflow; resolving a name is not proof that the person submitting the details owns the account.

Protect credentials and avoid repeated lookups

Make production resolution requests from your backend with the x-api-key header. Do not embed your API key into a publicly accessible form. Submit only when both fields are complete, and prevent repeated clicks while the request is pending. Read the errors guide for validation failures, invalid keys and daily limits. This endpoint looks up account information; it does not reserve funds, initiate a payment or configure a creator's payout account by itself.