Get a wallet - Docs

Fetches a wallet you created, using the id we gave you when you created it.

Endpoint

GET https://merchant.minisend.xyz/api/v1/wallets/{walletId}

Authorization: Bearer wsk_live_your_key_here

Use the wallet’s id (a long ID like 3f6b2e1a-...) in the URL, not your own wallet_ref. You get a 404 for a wallet on another account, and also for anything that isn’t a valid id, so sending a wallet_ref here by mistake gives you a 404 too. To look a wallet up by your own wallet_ref, use get a wallet by reference.

Example

curl https://merchant.minisend.xyz/api/v1/wallets/3f6b2e1a-... \
  -H "Authorization: Bearer wsk_live_your_key_here"

Response (200)

{
  "wallet": {
    "id": "3f6b2e1a-...",
    "tenant_id": "a7c9e2d0-...",
    "master_wallet_id": "d4f81b3c-...",
    "wallet_ref": "user-9214",
    "address": "0xabc1230000000000000000000000000000dead",
    "chain": "BASE",
    "chains": ["BASE", "MATIC", "ARB", "OP", "ETH", "AVAX", "ARC"],
    "status": "active",
    "mode": "live",
    "metadata": null,
    "created_at": "2026-07-29T09:00:00.000Z"
  }
}

Same shape as create wallet’s response.

Errors

Status	Meaning
`401`	Your API key is missing or wrong
`404`	We can’t find this wallet, it belongs to another account, or what’s in the URL isn’t a valid `id`