curl -X GET "https://api.tabsglobal.co/v1/beneficiaries" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch("https://api.tabsglobal.co/v1/beneficiaries", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
});
const beneficiaries = await response.json();
console.log(beneficiaries);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/beneficiaries",
headers={"Authorization": f"Bearer {API_KEY}"},
)
print(response.json())
[
{
"id": "ben_4a8e2b1c-9f0d-4e5a-8b2c-1d0f3a4b5c6d",
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"bankName": "Guaranty Trust Bank",
"currency": "NGN"
},
"createdAt": "2026-09-21T01:30:00.000Z"
}
]
Beneficiaries API
List Beneficiaries
Retrieve all saved payout beneficiaries for your merchant account.
GET
/
v1
/
beneficiaries
curl -X GET "https://api.tabsglobal.co/v1/beneficiaries" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch("https://api.tabsglobal.co/v1/beneficiaries", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
});
const beneficiaries = await response.json();
console.log(beneficiaries);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/beneficiaries",
headers={"Authorization": f"Bearer {API_KEY}"},
)
print(response.json())
[
{
"id": "ben_4a8e2b1c-9f0d-4e5a-8b2c-1d0f3a4b5c6d",
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"bankName": "Guaranty Trust Bank",
"currency": "NGN"
},
"createdAt": "2026-09-21T01:30:00.000Z"
}
]
Fetches all saved recipient profiles that you can reuse across multiple payouts.
Scopes required
beneficiaries:read or *
Headers
string
required
Bearer API secret key formatted as
Bearer sk_live_... or Bearer sk_test_....Response
array
curl -X GET "https://api.tabsglobal.co/v1/beneficiaries" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch("https://api.tabsglobal.co/v1/beneficiaries", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
});
const beneficiaries = await response.json();
console.log(beneficiaries);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/beneficiaries",
headers={"Authorization": f"Bearer {API_KEY}"},
)
print(response.json())
[
{
"id": "ben_4a8e2b1c-9f0d-4e5a-8b2c-1d0f3a4b5c6d",
"type": "BANK_ACCOUNT",
"details": {
"accountName": "ADEWALE ADELEKE",
"accountNumber": "0123456789",
"bankCode": "058",
"bankName": "Guaranty Trust Bank",
"currency": "NGN"
},
"createdAt": "2026-09-21T01:30:00.000Z"
}
]
