Get payout details

GET
/payouts/{id}

Fetch particular payout details, including its current status, settled amounts, rate and on-chain transaction (once known).

Authorization

Bearer
headerAuthorizationBearer <JWT>

OAuth access token.

Path Parameters

id*string

Identifier of the payout.

Formatuuid

Header Parameters

X-Volt-Api-Version*1

Version of the API used. Currently, version 1 is the only version.

Value in1

Response Body

OK - Successful request, returning given payout's details.

application/json
  1. response
id*string

Identifier of the payout.

Formatuuid
walletId*string

Identifier of the wallet the payout is debited from.

Formatuuid
status*PayoutStatusEnum

Payout status.

Value in"PENDING""PROCESSING""ON_HOLD""COMPLETED""FAILED""CANCELLED"
type*"CRYPTO"

Payout type, inferred from currency.

Value in"CRYPTO"
payoutReference*string

Unique reference for the payout — merchant-supplied or Volt-generated.

Lengthlength <= 18
internalReference*|

Internal identifier of the payout in the partner's system.

debited*|

The wallet leg. This field is null until the payout executes, then carries the settled debited amount.

paid*

The on-chain leg, populated from the request at creation.

rate*|

Settled conversion rate as an exact decimal string: 1 unit of the debited currency equals rate units of the paid currency. This field is null until the payout executes.

beneficiary*||

The counterparty identity held against the payout.

crypto*

The on-chain destination. Present for crypto payouts.

transaction*|

On-chain evidence for the payout. Present for crypto payouts. This field is null until the on-chain transaction is known.

failureReason*|

This field is null unless status is FAILED.

Value in"REJECTED_BY_PROVIDER""INSUFFICIENT_FUNDS""INVALID_ADDRESS""WALLET_NOT_FOUND""WALLET_MERCHANT_MISMATCH""COMPLIANCE_REJECTED""RETURNED""INTERNAL_ERROR"
createdAt*string

Date of payout creation.

Formatdate-time
updatedAt*|

Date of payout's last update.

Formatdate-time
Example Request
curl -X GET 'https://stablecoins.sandbox.volt.io/payouts/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'X-Volt-Api-Version: 1'
Example Response
{  "id": "7f3b9d1e-5a2c-4e6f-b8d0-a4c6e8f0b2d4",  "walletId": "6a4f0c9e-2d1b-4c8a-9f3e-b7d2a1c4e5f6",  "status": "COMPLETED",  "type": "CRYPTO",  "payoutReference": "K7KDN3PA84MRV2XQZ9",  "internalReference": "TREASURY-09",  "debited": {    "amount": "150.000000",    "currency": "USDC"  },  "paid": {    "amount": "150.000000",    "currency": "USDC"  },  "rate": "1.000000",  "beneficiary": {    "type": "INDIVIDUAL",    "firstName": "Jane",    "lastName": "Doe",    "country": "DE"  },  "crypto": {    "address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",    "network": "ETHEREUM",    "tag": null  },  "transaction": {    "hash": "0x9a7f1e2d3c4b5a6978869504132abfe9988776655443322110099aabbccdde",    "detectedAt": "2026-09-02T10:13:11+00:00",    "confirmedAt": "2026-09-02T10:14:02+00:00"  },  "failureReason": null,  "createdAt": "2026-09-02T10:12:03+00:00",  "updatedAt": "2026-09-02T10:14:02+00:00"}