curl -X GET "https://api.tabsglobal.co/v1/payouts" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch("https://api.tabsglobal.co/v1/payouts", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
});
const payouts = await response.json();
console.log(payouts);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/payouts",
headers={"Authorization": f"Bearer {API_KEY}"},
)
print(response.json())
[
{
"id": "7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
"reference": "PO-AB12CD34",
"type": "PAYOUT",
"status": "SUCCESS",
"currency": "NGN",
"amountMinor": "2500000",
"ngnAmountMinor": "2500000",
"recipient": "ADEWALE ADELEKE",
"metadata": {
"railReference": "NIP-9948102941",
"provider": "embedly"
},
"completedAt": "2026-09-21T02:00:15.000Z",
"createdAt": "2026-09-21T02:00:00.000Z"
}
]
Payouts API
List Payouts
Retrieve historical payouts executed by this merchant account.
GET
/
v1
/
payouts
curl -X GET "https://api.tabsglobal.co/v1/payouts" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch("https://api.tabsglobal.co/v1/payouts", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
});
const payouts = await response.json();
console.log(payouts);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/payouts",
headers={"Authorization": f"Bearer {API_KEY}"},
)
print(response.json())
[
{
"id": "7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
"reference": "PO-AB12CD34",
"type": "PAYOUT",
"status": "SUCCESS",
"currency": "NGN",
"amountMinor": "2500000",
"ngnAmountMinor": "2500000",
"recipient": "ADEWALE ADELEKE",
"metadata": {
"railReference": "NIP-9948102941",
"provider": "embedly"
},
"completedAt": "2026-09-21T02:00:15.000Z",
"createdAt": "2026-09-21T02:00:00.000Z"
}
]
Fetches historical payout transactions initiated by your merchant account.
Scopes required
payouts:read or *
Headers
string
required
Bearer API secret key formatted as
Bearer sk_live_... or Bearer sk_test_....Response
array
Array of payout transaction records.
Show Transaction properties
Show Transaction properties
string
Transaction UUID.
string
Payout reference code.
string
Transaction type (
PAYOUT).string
Settlement status:
PROCESSING, PENDING, SUCCESS, or FAILED.string
Currency code.
string
Amount in minor currency units as string.
string
Total NGN debit in minor units.
string
Beneficiary name.
string
Creation timestamp.
curl -X GET "https://api.tabsglobal.co/v1/payouts" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch("https://api.tabsglobal.co/v1/payouts", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
});
const payouts = await response.json();
console.log(payouts);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/payouts",
headers={"Authorization": f"Bearer {API_KEY}"},
)
print(response.json())
[
{
"id": "7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
"reference": "PO-AB12CD34",
"type": "PAYOUT",
"status": "SUCCESS",
"currency": "NGN",
"amountMinor": "2500000",
"ngnAmountMinor": "2500000",
"recipient": "ADEWALE ADELEKE",
"metadata": {
"railReference": "NIP-9948102941",
"provider": "embedly"
},
"completedAt": "2026-09-21T02:00:15.000Z",
"createdAt": "2026-09-21T02:00:00.000Z"
}
]