> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minisend.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a wallet by reference

> Look a wallet up by your own identifier instead of Minisend's id.

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

```text theme={null}
GET https://merchant.minisend.xyz/api/v1/wallets/by-ref/{walletRef}
```

```text theme={null}
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

```bash theme={null}
curl https://merchant.minisend.xyz/api/v1/wallets/by-ref/user-9214 \
  -H "Authorization: Bearer wsk_live_your_key_here"
```

## Response (200)

```json theme={null}
{
  "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](/api-reference/wallet-api/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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.