Payouts

Get a Payout Request

Changed on

Gets the Payout Request identified by the provided ID.

get/api/payouts/payout/{id}

Request

Path parameters

idstring uuid required

Payout request ID

Headers

on-behalf-ofstring

Organization ID to act on behalf of

Response

Returned Payout Request

createdAtstring date-time required
idstring uuid required
memostring
sourceAccountIdstring uuid required
status'AWAITING_EXECUTION' | 'CANCELED' | 'PENDING' | 'EXECUTED' | 'FAILED' required

DEPRECATED: use statusV2 instead. The status of the overall payout request. The initial status is AWAITING_EXECUTION, and the status will change to PENDING. EXECUTED, FAILED, and CANCELED are terminal statuses. EXECUTED indicates the blockchain transaction associated with the entire payout has been executed, but that does not mean your recipients have received funds. Check the individual recipientsPayoutDetails for the status of each recipient.

transactionHashstring

The transaction hash of the blockchain transaction. Present when the status is EXECUTED.

updatedAtstring date-time required

Example response

{
  "payouts": [
    {
      "amount": {
        "tokenSymbol": "USDC"
      },
      "details": {
        "feeTotal": {
          "tokenSymbol": "USDC"
        },
        "fiatAmount": {
          "fiatCurrencyCode": "USD"
        },
        "transactionFee": {
          "tokenSymbol": "USDC"
        }
      },
      "recipientInfo": {
        "details": {
          "details": {
            "truncatedBankAccountNumber": "****1234"
          }
        }
      }
    }
  ]
}

Changes

    • warning

      added the new SignedAgreementRequiredException enum value to the response property for the response status

    • warning

      added the new TRON enum value to the //// response property for the response status

    • warning

      added the new TRON enum value to the ////// response property for the response status

    • warning

      added the new mxn-debit-card enum value to the //// response property for the response status

    • warning

      added the new usd-el-salvador enum value to the //// response property for the response status

    • info

      added the non-success response with the status

    • info

      removed the SOLANA enum value from the //// response property for the response status

    • info

      removed the SOLANA enum value from the ////// response property for the response status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status