Get a withdrawal - Docs

Returns one withdrawal or recovery, looked up by the id from its creation response.

Endpoint

GET https://merchant.minisend.xyz/api/v1/withdrawals/{withdrawalId}

Authorization: Bearer wsk_live_your_key_here

Needs wallets:read. Scoped to your account: an id belonging to someone else comes back as 404, not 403, so it never confirms the id exists.

Example

curl https://merchant.minisend.xyz/api/v1/withdrawals/9f2c4e1a-... \
  -H "Authorization: Bearer wsk_live_your_key_here"

Response (200)

{
  "withdrawal": {
    "id": "9f2c4e1a-...",
    "state": "completed",
    "source": "master",
    "chain": "BASE",
    "token": "USDC",
    "amount": "50.000000",
    "destination_address": "0x9f2c000000000000000000000000000000dead",
    "tx_hash": "0x55a572efe1720250e442f38741477a4fc3f7f152e5cd208cc52f8222a1c2a13b",
    "created_at": "2026-09-28T09:00:00.000Z",
    "updated_at": "2026-09-28T09:00:12.000Z"
  }
}

Same shape as request a withdrawal’s response. The reason a failed withdrawal failed isn’t included here — check your dashboard for that.

Errors

Status	Meaning
`401`	Missing or invalid API key
`404`	Unknown id, or it belongs to another account
`503`	Could not read it right now. Retry