Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.nomba.com/llms.txt

Use this file to discover all available pages before exploring further.

Perform bank account lookup

Perform a bank account lookup before processing bank transfer payments
You can use this to retrieve the specific bankCode for any desired bank.
Always verify a recipient account before initiating a transfer. This confirms the account exists and returns the account holder’s name — which you should display to your user for confirmation before sending funds.

​
POST /v1/transfers/bank/lookup

curl --request POST \
  --url https://api.nomba.com/v1/transfers/bank/lookup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "accountNumber": "0554772814",
  "bankCode": "053"
}'

​
Request body

​
accountNumber
string
required
The account number to be looked up.
​
bankCode
string
required
The code of the bank that the account number belongs to. Obtain this from GET /v1/transfers/banks.

​
Response body

​
code
string
required
Response code. "00" indicates a valid account was found.
​
description
string
required
Response description.
​
data
object