Get Payout

GET/payouts/:payoutId

Description

Retrieve a payout by id, including its current status and the off-ramp progress.

Headers

Header	Description	Required
Authorization	Bearer token with your API key	yes

Path Parameters

Name	Type	Description	Required
payoutId	string	The unique identifier of the payout.	yes

Example Request

const response = await fetch('https://checkout-api.exodus-int.com/payouts/pyt_5t6u7v', {
  headers: {
    Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
  },
});

Response

SUCCESSFUL RESPONSE

{
  "id": "pyt_5t6u7v",
  "object": "payout",
  "status": "completed",
  "customer_id": "cus_9z8y7x",
  "beneficiary_id": "ben_1a2b3c",
  "amount": 150000,
  "currency": "EUR",
  "reference": "Invoice INV-1042",
  "detected_chain": "ethereum",
  "detected_token": "USDC",
  "created_at": "2026-06-04T12:05:00Z",
  "completed_at": "2026-06-04T12:35:00Z"
}

The status progresses deposit_pending → deposit_detected → forwarded → completed, with the terminal states failed, refunded, and expired. (forwarded is the state while the off-ramp is in progress; the payout.forwarded webhook fires on that transition.)

Error Responses

NOT FOUND

{
  "error": {
    "type": "not_found",
    "message": "Payout not found"
  }
}