curl -X POST "https://api.tabsglobal.co/v1/payouts/name-enquiry" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"bankCode": "058",
"accountNumber": "0123456789"
}'
const response = await fetch("https://api.tabsglobal.co/v1/payouts/name-enquiry", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
bankCode: "058",
accountNumber: "0123456789",
}),
});
const verification = await response.json();
console.log(verification);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/payouts/name-enquiry",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"bankCode": "058", "accountNumber": "0123456789"},
)
print(response.json())
{
"accountNumber": "0123456789",
"accountName": "ADEWALE ADELEKE",
"bankCode": "058"
}
Payouts API
Resolve Bank Account Name
Verify recipient account details against the national banking switch before initiating a payout.
POST
/
v1
/
payouts
/
name-enquiry
curl -X POST "https://api.tabsglobal.co/v1/payouts/name-enquiry" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"bankCode": "058",
"accountNumber": "0123456789"
}'
const response = await fetch("https://api.tabsglobal.co/v1/payouts/name-enquiry", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
bankCode: "058",
accountNumber: "0123456789",
}),
});
const verification = await response.json();
console.log(verification);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/payouts/name-enquiry",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"bankCode": "058", "accountNumber": "0123456789"},
)
print(response.json())
{
"accountNumber": "0123456789",
"accountName": "ADEWALE ADELEKE",
"bankCode": "058"
}
Performs real-time account name enquiry against the destination banking switch to confirm the account holder’s legal name before executing transfers.
Scopes required
payouts:read or *
Headers
string
required
Bearer API secret key formatted as
Bearer sk_live_... or Bearer sk_test_....Body
string
required
The destination bank’s 3-digit code (e.g.
058 for GTBank).string
required
The 10-digit NUBAN account number.
Response
string
The validated 10-digit account number.
string
The registered full name of the account holder.
string
The bank code verified.
curl -X POST "https://api.tabsglobal.co/v1/payouts/name-enquiry" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"bankCode": "058",
"accountNumber": "0123456789"
}'
const response = await fetch("https://api.tabsglobal.co/v1/payouts/name-enquiry", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
bankCode: "058",
accountNumber: "0123456789",
}),
});
const verification = await response.json();
console.log(verification);
import requests
response = requests.post(
"https://api.tabsglobal.co/v1/payouts/name-enquiry",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={"bankCode": "058", "accountNumber": "0123456789"},
)
print(response.json())
{
"accountNumber": "0123456789",
"accountName": "ADEWALE ADELEKE",
"bankCode": "058"
}