curl -X GET "https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch(
"https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
{
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
}
);
const payout = await response.json();
console.log(payout);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
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"
},
"createdAt": "2026-09-21T02:00:00.000Z",
"completedAt": "2026-09-21T02:00:15.000Z",
"payout": {
"rate": 1,
"transferFeeMinor": "0",
"totalDebitMinor": "2500000",
"recipientAddress": null,
"bank": null,
"accountNumber": "0123456789",
"routing": null,
"sortCode": null,
"iban": null,
"bic": null,
"narration": "Invoice settlement #1042",
"eta": "Instant",
"railReference": "NIP-9948102941"
}
}
Payouts API
Get Payout Details
Retrieve real-time status and settlement details for an individual payout.
GET
/
v1
/
payouts
/
{id}
curl -X GET "https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch(
"https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
{
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
}
);
const payout = await response.json();
console.log(payout);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
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"
},
"createdAt": "2026-09-21T02:00:00.000Z",
"completedAt": "2026-09-21T02:00:15.000Z",
"payout": {
"rate": 1,
"transferFeeMinor": "0",
"totalDebitMinor": "2500000",
"recipientAddress": null,
"bank": null,
"accountNumber": "0123456789",
"routing": null,
"sortCode": null,
"iban": null,
"bic": null,
"narration": "Invoice settlement #1042",
"eta": "Instant",
"railReference": "NIP-9948102941"
}
}
Fetches the complete details and execution breakdown of a single payout by its transaction UUID.
Scopes required
payouts:read or *
Path parameters
string
required
The unique transaction identifier (e.g.
7d9c0245-31ba-4f27-a0c3-fba4313f89e2).Headers
string
required
Bearer API secret key formatted as
Bearer sk_live_... or Bearer sk_test_....Response
string
Unique transaction identifier.
string
Payout reference code.
string
Transaction type (
PAYOUT).string
Status:
PROCESSING, PENDING, SUCCESS, or FAILED.string
Currency code.
string
Amount in minor units as string.
string
Total NGN debit in minor units.
string
Beneficiary full legal name.
object
Integration metadata.
string
Creation timestamp.
string
Settlement completion timestamp, or null if pending.
object
Detailed payout record.
curl -X GET "https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2" \
-H "Authorization: Bearer sk_live_..."
const response = await fetch(
"https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
{
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
},
}
);
const payout = await response.json();
console.log(payout);
import requests
response = requests.get(
"https://api.tabsglobal.co/v1/payouts/7d9c0245-31ba-4f27-a0c3-fba4313f89e2",
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"
},
"createdAt": "2026-09-21T02:00:00.000Z",
"completedAt": "2026-09-21T02:00:15.000Z",
"payout": {
"rate": 1,
"transferFeeMinor": "0",
"totalDebitMinor": "2500000",
"recipientAddress": null,
"bank": null,
"accountNumber": "0123456789",
"routing": null,
"sortCode": null,
"iban": null,
"bic": null,
"narration": "Invoice settlement #1042",
"eta": "Instant",
"railReference": "NIP-9948102941"
}
}