Skip to main content
GET
/
v2
/
wallets
/
{id}
/
withdrawals
/
{withdrawalId}
Get a single withdrawal
curl --request GET \
  --url https://sandbox.groundtech.co/v2/wallets/{id}/withdrawals/{withdrawalId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "w1a2b3c4-0000-4000-8000-000000000001",
  "amountRequestedUsd": "50.000000",
  "amountPaidUsd": "50.000000",
  "feeUsd": "0.000000",
  "destinationChain": "arbitrum",
  "destinationAddress": "0x76F8fc6667E239f83a547d4e16225d6a34f6FA22",
  "destinationToken": "usdc",
  "status": "completed",
  "failureReason": null,
  "createdAt": "2025-09-05T10:00:00Z",
  "completedAt": "2025-09-05T10:05:00Z",
  "legsCompleted": 1,
  "legsTotal": 1,
  "payoutLegs": [
    {
      "from": {
        "kind": "cash",
        "id": "cash:arbitrum:usdc",
        "label": "Cash (Arbitrum)"
      },
      "to": {
        "kind": "external_payout",
        "id": "external_payout:arbitrum:usdc",
        "label": "External payout (Arbitrum)"
      },
      "status": "completed",
      "amountUsd": "50.000000",
      "startedAt": "2025-09-05T10:00:00Z",
      "completedAt": "2025-09-05T10:05:00Z",
      "stepsCompleted": 1,
      "stepsTotal": 1,
      "steps": [
        {
          "name": "Sending payout",
          "stepKind": "external_payout_transfer",
          "sequenceRole": "external_payout_transfer",
          "protocolType": "external_payout",
          "stepOrdinal": 0,
          "chain": "arbitrum",
          "txKind": "external_payout_transfer",
          "state": "completed",
          "startedAt": "2025-09-05T10:00:00Z",
          "completedAt": "2025-09-05T10:05:00Z",
          "cancelledAt": null
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Wallet ID

​
withdrawalId
string<uuid>
required

Withdrawal ID

Response

Withdrawal details

​
id
string<uuid>
​
amountRequestedUsd
string | null

Requested withdrawal amount in USD as a formatted string.

​
amountPaidUsd
string | null

Completed payout amount in USD as a formatted string. Null until at least one payout completes.

​
feeUsd
string | null

Fee charged for the withdrawal as a formatted string.

​
destinationChain
enum<string>

Destination chain for the withdrawal.

Available options:
arbitrum,
base,
ethereum,
ethereum_sepolia,
polygon,
solana,
solana_devnet
​
destinationAddress
string
​
destinationToken
enum<string>
Available options:
usdc
​
status
enum<string>

Simplified withdrawal status. partially_completed means at least one payout leg delivered value and at least one leg failed or was cancelled.

Available options:
processing,
completed,
partially_completed,
failed,
cancelled
​
legsCompleted
integer
​
legsTotal
integer
​
payoutLegs
object[]

Source-to-destination payout workflow legs.

​
failureReason
string | null

Human-readable reason for failure (only present when status is failed).

​
createdAt
string<date-time>
​
completedAt
string<date-time> | null