Get a payout
Fetch a single payout batch with its full per-item breakdown.
GET
/v1/payouts/:idpayout
Fetches a single payout, with its full items breakdown. Poll this (or react to
webhooks) to watch a processing batch resolve and to read each item's outcome.
GET /payouts/:idscope: payoutTest keys only. Never paste a live key. Your key is stored only in this browser (localStorage) and sent only to the same-origin playground proxy.
›Equivalent request (curl / TypeScript)
curl -X GET https://sandbox.api.acute.network/v1/payouts/acuinf771045620398pyo \ -H "Authorization: Bearer acuinf_test_…"
const res = await fetch("https://sandbox.api.acute.network/v1/payouts/acuinf771045620398pyo", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.ACUTE_TEST_KEY}`,
},
});
const { data, meta } = await res.json();# read a payout
curl https://sandbox.api.acute.network/v1/payouts/acuinf771045620398pyo \
-H "Authorization: Bearer acuinf_test_…"{
"success": true,
"statusCode": 200,
"data": {
"id": "acuinf771045620398pyo",
"sourceWalletId": "acuinf483920175566wlt",
"totalAmount": 1500000,
"totalFee": 36000,
"itemCount": 3,
"status": "partially_completed",
"items": [
{
"id": "acuinf610248379915poi",
"amount": 500000,
"fee": 12000,
"status": "completed",
"counterparty": { "accountNumber": "0123456789", "accountName": "ADA LOVELACE", "bankCode": "044" },
"failureReason": null
},
{
"id": "acuinf338817240056poi",
"amount": 250000,
"fee": 12000,
"status": "failed",
"counterparty": { "accountNumber": "1098765432", "accountName": null, "bankCode": "058" },
"failureReason": "Beneficiary account not found at the bank rail."
},
{
"id": "acuinf905513620847poi",
"amount": 750000,
"fee": 12000,
"status": "completed",
"counterparty": { "accountNumber": "2233445566", "accountName": null, "bankCode": "033" },
"failureReason": null
}
],
"currency": "NGN",
"createdAt": "2026-06-24T10:40:09.224Z"
},
"meta": { "requestId": "req_4f9c2a7e1b0d8c3a5e6f10a2" }
}idstringpathrequiredThe payout reference (acuinf…pyo).
Returns PayoutResponseData - the same shape as
create a payout.
dataPayoutResponseDatarequiredThe payout batch, including its status, totalFee, and the per-item items breakdown (each
carrying its own fee, status, and failureReason).