Get a wallet's deposits

Lists every deposit one wallet has received. It’s the way to check yourself instead of waiting for the wallet.deposit.received webhook, and how you catch up if your server was down for longer than we keep retrying.

Endpoint

GET https://merchant.minisend.xyz/api/v1/wallets/{walletId}/deposits

Authorization: Bearer wsk_live_your_key_here

Query parameters

number

default:"20"

How many to return at once, up to 100.

number

default:"0"

How many to skip. Use it to get the next page.

Example

curl "https://merchant.minisend.xyz/api/v1/wallets/3f6b2e1a-.../deposits?limit=50" \
  -H "Authorization: Bearer wsk_live_your_key_here"

Response (200)

{
  "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",
      "settlement": null
    }
  ],
  "total": 3,
  "limit": 50,
  "offset": 0
}

Each deposit has the same fields as the wallet.deposit.received webhook, plus one more:

object

Only there if you’ve set a settlement network and this deposit needed moving because of it. Otherwise null, including when the deposit already arrived as USDC on your settlement network, so there was nothing to do.

Show settlement fields

string

required

queued, settling, delayed, settled, failed, or skipped_below_minimum. See Settlement for what each one means.

string

required

Your settlement network when this deposit arrived.

string

What arrived on chain, once settled. Otherwise null.

string

The transaction ID that delivered the money on chain, once settled.

string

A plain sentence for failed, delayed, or skipped_below_minimum. null for every other status.

string

Only set when status is failed. See Settlement.

Errors

Status	Meaning
`401`	Your API key is missing or wrong
`404`	We can’t find this wallet, or it belongs to another account

Overview

Endpoints

Off-ramp endpoints

Onramp endpoints

Wallet API endpoints

Get a wallet's deposits

Endpoint

Query parameters

Example

Response (200)

Errors

​Endpoint

​Query parameters

​Example

​Response (200)

​Errors

Endpoint

Query parameters

Example

Response (200)

Errors