Skip to main content

Get Payout

Retrieves the current merchant view of one payout.

GET/api/payout/{payout_id}

Authentication​

Scope: payouts:read

Authorization: Bearer <YOUR_PAYOUT_KEY>

Path Parameters​

FieldTypeDescriptionRequired
payout_idstringThe payout id returned by Create Payout, e.g. po_9f3c…✅

Response Fields​

{
  "payout_id": "po_9f3c1d7b2a8e4c15d0b6a291",
  "status": "paid",
  "status_version": 4,
  "amount": "25.00",
  "fee": "0.50",
  "total_reserved": "25.50",
  "currency": "USD",
  "funds_released": false,
  "merchant_reference": "refund-ORD-10231",
  "customer_id": null,
  "delivery": "link",
  "source": "api",
  "case_reference": null,
  "selected_method": "cashapp",
  "safe_reason": null,
  "receipt_reference": "rcpt_4f2a8c1d9b3e5a7c6d0f",
  "created_at": "2026-09-28T09:14:22Z",
  "accepted_at": "2026-09-28T09:31:07Z",
  "payout_expires_at": "2026-10-05T09:14:22Z",
  "updated_at": "2026-09-28T09:33:41Z"
}

Field meanings and the status table: Payout statuses. The recipient's address and transaction identifiers are never returned.

Request Samples​

curl -s https://luxfin.org/api/payout/po_9f3c1d7b2a8e4c15d0b6a291 \
  -H "Authorization: Bearer $PAYOUT_KEY"