Get a wallet by reference - Docs

Finds a wallet using the walletRef you gave it when you created it, so you don’t need to save our id as well as your own.

Endpoint

GET https://merchant.minisend.xyz/api/v1/wallets/by-ref/{walletRef}

Authorization: Bearer wsk_live_your_key_here

It only looks in your account, so it doesn’t matter if another business uses the same walletRef (like user_1).

Example

curl https://merchant.minisend.xyz/api/v1/wallets/by-ref/user-9214 \
  -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
`400`	`walletRef` needs to be 1 to 128 characters, using letters, numbers, or `_ : . -`
`401`	Your API key is missing or wrong
`404`	There’s no wallet with this ID on your account