Resolve bank account
curl --request POST \
--url https://api-prod.blaaiz.com/api/external/bank/account-lookup \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"account_number": "0123456789",
"bank_id": "044"
}
'import requests
url = "https://api-prod.blaaiz.com/api/external/bank/account-lookup"
payload = {
"account_number": "0123456789",
"bank_id": "044"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({account_number: '0123456789', bank_id: '044'})
};
fetch('https://api-prod.blaaiz.com/api/external/bank/account-lookup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api-prod.blaaiz.com/api/external/bank/account-lookup")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"0123456789\",\n \"bank_id\": \"044\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-prod.blaaiz.com/api/external/bank/account-lookup",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '0123456789',
'bank_id' => '044'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"message": "Account resolved successfully",
"account_name": "John Doe"
}{
"message": "Invalid account number or bank code"
}{
"message": "Invalid or missing access token"
}Bank
Resolve bank account
Verify the validity of a bank account by providing account number and bank_id. Required scope: bank:read.
POST
/
api
/
external
/
bank
/
account-lookup
Resolve bank account
curl --request POST \
--url https://api-prod.blaaiz.com/api/external/bank/account-lookup \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"account_number": "0123456789",
"bank_id": "044"
}
'import requests
url = "https://api-prod.blaaiz.com/api/external/bank/account-lookup"
payload = {
"account_number": "0123456789",
"bank_id": "044"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({account_number: '0123456789', bank_id: '044'})
};
fetch('https://api-prod.blaaiz.com/api/external/bank/account-lookup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api-prod.blaaiz.com/api/external/bank/account-lookup")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"0123456789\",\n \"bank_id\": \"044\"\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-prod.blaaiz.com/api/external/bank/account-lookup",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '0123456789',
'bank_id' => '044'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"message": "Account resolved successfully",
"account_name": "John Doe"
}{
"message": "Invalid account number or bank code"
}{
"message": "Invalid or missing access token"
}Authorizations
Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.
Body
application/json
This endpoint allows you to verify the validity of a bank account by providing the account number and the associated bank ID. It returns information about the account, such as the account holder's name, to ensure accuracy before initiating transactions. We advise using this to confirm recipient details for payments, transfers, or any transaction involving a bank account. Example Use Cases:
- Validate a recipient's bank account details during payment setup.
- Ensure accurate data entry before processing a transaction.
- Provide real-time verification for user onboarding or payout processes.
Response
Account resolved successfully
Name of the account holder
Was this page helpful?