> ## 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's deposits

> Paginated deposit history for one wallet, newest first.

Returns the deposit history for one wallet. It's the polling counterpart to the [`wallet.deposit.received` webhook](/wallet-api/webhooks), and how you catch up after your endpoint was down longer than the retry window.

## Endpoint

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

```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/3f6b2e1a-.../deposits?limit=50" \
  -H "Authorization: Bearer wsk_live_your_key_here"
```

## Response (200)

```json theme={null}
{
  "deposits": [
    {
      "id": "7b2e1a3f-...",
      "tenant_id": "a7c9e2d0-...",
      "wallet_id": "3f6b2e1a-...",
      "wallet_ref": "user-9214",
      "address": "0xabc1230000000000000000000000000000dead",
      "chain": "MATIC",
      "token": "USDC",
      "amount": "10.500000",
      "tx_hash": "0x55a572efe1720250e442f38741477a4fc3f7f152e5cd208cc52f8222a1c2a13b",
      "from_address": "0x9f2c...",
      "state": "complete",
      "detected_at": "2026-08-07T09:12:03.000Z",
      "created_at": "2026-08-07T09:12:03.000Z"
    }
  ],
  "total": 3,
  "limit": 50,
  "offset": 0
}
```

Same deposit shape as the [`wallet.deposit.received`](/wallet-api/webhooks) webhook.

## Errors

| Status | Meaning                                          |
| ------ | ------------------------------------------------ |
| `401`  | Missing or invalid API key                       |
| `404`  | Unknown wallet, or it belongs to another account |