NeroPay Docs
API & Integrations

List and Retrieve Payouts

Payouts

List and Retrieve Payouts

Use payout list and retrieve endpoints for reconciliation and payout status tracking.

GETReconciliationStatus

List payouts

GET/payouts

Lists payout requests for the authenticated merchant or selected connected account.

GET/nerodisburse/payouts

Lists NeroDisburse payout requests.

 true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $secretKey,
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $response;
{
  "success": true,
  "data": [
    {
      "id": 148468,
      "status": "paid",
      "amount": "1.00",
      "currency": "GBP",
      "reference": "SUPPLIER-1001",
      "created_at": "2026-04-08T14:38:52Z",
      "transfer_details": {
        "recipient": "Jane Merchant",
        "bank": {
          "name": "Demo Bank",
          "last4": "2345"
        }
      }
    }
  ]
}

Retrieve payout

GET/payouts/{id}

Retrieves one payout by id.

 true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $secretKey,
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $response;
{
  "success": true,
  "data": {
    "id": 148468,
    "status": "paid",
    "amount": "1.00",
    "currency": "GBP",
    "reference": "SUPPLIER-1001",
    "payout_status": "paid",
    "created_at": "2026-04-08T14:38:52Z",
    "transfer_details": {
      "recipient": "Jane Merchant",
      "purpose": "supplier",
      "bank": {
        "name": "Demo Bank",
        "last4": "2345"
      }
    }
  }
}

Filters

ParameterTypeRequiredDescription
statusstringOptionalFilter by payout status such as pending, paid or cancelled.
fromdateOptionalStart date for created_at filtering.
todateOptionalEnd date for created_at filtering.
limitintegerOptionalPage size.
pageintegerOptionalPage number.