Skip to main content
You can track the status of the payout items in a payout batch using the Payouts API.
  • Send a GET request to /v1/payments/payouts-item/{payout_item_id}. Replace {payout_item_id} with the payout item ID retrieved from the Show payout batch details response.
  • The response includes the transaction_status for each payout item in the batch.
The following table summarizes payout statuses at the item level:
StatusDescription
PENDINGPayPal processes your payout. The recipient receives the money after processing.
SUCCESSPayPal credits money to the recipient’s account.
UNCLAIMEDThe recipient does not have a PayPal or Venmo account. PayPal sends a signup link, and the payout status stays unclaimed until claimed or returned.
REFUNDEDThe recipient refunds the payout. The money returns to your account.
FAILEDThe payout fails, and PayPal does not deduct money from your account.
ON_HOLDPayPal reviews the payout. The payout stays temporarily on hold.
BLOCKEDPayPal blocks the payout request.
DENIEDPayPal denies the payout. Money is not deducted from your account.
RETURNEDMoney returns to your account. This happens if the recipient does not claim the payout or you cancel it.
curl -v -X GET https://api-m.sandbox.paypal.com/v1/payments/payouts-item/8AELMXH8UB2P8 \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS-TOKEN>'
⌘I