Get a wallet by reference - Docs

Looks up a wallet using the walletRef you supplied at creation, so you never need to persist Minisend’s id alongside your own identifier.

Endpoint

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

Authorization: Bearer wsk_live_your_key_here

Scoped to your account: two tenants can each use the same walletRef (e.g. user_1) without colliding.

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",
    "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` isn’t 1-128 chars of letters, numbers, or `_ : . -`
`401`	Missing or invalid API key
`404`	No wallet with this reference on your account