> ## 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.

# List wallets

> Paginated list of every wallet you've created, newest first.

Lists your wallets, newest first.

## Endpoint

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

```text theme={null}
Authorization: Bearer wsk_live_your_key_here
```

## Query parameters

<ParamField query="limit" default="20" type="number">
  Page size, max 100.
</ParamField>

<ParamField query="offset" default="0" type="number">
  Rows to skip.
</ParamField>

## Example

```bash theme={null}
curl "https://merchant.minisend.xyz/api/v1/wallets?limit=50" \
  -H "Authorization: Bearer wsk_live_your_key_here"
```

## Response (200)

```json theme={null}
{
  "wallets": [
    {
      "id": "3f6b2e1a-...",
      "tenant_id": "a7c9e2d0-...",
      "master_wallet_id": "d4f81b3c-...",
      "wallet_ref": "user-9214",
      "address": "0xabc1230000000000000000000000000000dead",
      "chain": "BASE",
      "status": "active",
      "mode": "live",
      "created_at": "2026-07-29T09:00:00.000Z"
    }
  ],
  "total": 41,
  "limit": 50,
  "offset": 0
}
```

<ResponseField name="wallets" type="array" required>
  Full wallet objects, same shape as [create wallet](/api-reference/wallet-api/create-wallet).
</ResponseField>

<ResponseField name="total" type="number" required>
  Total wallets matching your account. Use with `limit`/`offset` to paginate.
</ResponseField>

<ResponseField name="limit" type="number" required>
  The page size actually applied, not the one you asked for. Requests above 100 come back as `100`, and a missing or unparseable value comes back as the `20` default.
</ResponseField>

<ResponseField name="offset" type="number" required>
  The offset actually applied. Negative and unparseable values come back as `0`.
</ResponseField>