# List Wallet Payouts

The user's payouts paid from their own wallet, newest first, in one environment.

## Overview

- Lists the payouts created with [Pay Out a Quote from Your Wallet](https://docs.aureahub.com/docs/payout-wallet-pay.md) — the user's own, in the environment named by `isTestnet`, sorted newest first. Each item has exactly the shape of that endpoint's answer.
- **Hosted checkout payouts are never listed here.** Those are the ones of [Initiate Payout](https://docs.aureahub.com/docs/payout-initiate.md), and [List Payout Transactions](https://docs.aureahub.com/docs/payout-list.md) lists them.
- `page` is an integer from `1` (default `1`) and `limit` an integer from `1` to `100` (default `20`); anything outside answers `400`. `total` counts the user's payouts in that environment and `totalPages` follows `limit`.
- It needs a tenant (`403` otherwise) and nothing else: payouts stay readable after your tenant switches the bank ramp payouts off, and a user without a bank ramp profile gets an empty list. The bank ramp is not called.

## Endpoint

### `GET /v1/ramp/bank/payout/payouts`

Authentication: bearer token required.

Returns the user's payouts paid from their own wallet in one environment.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the bank ramp's sandbox; `false` or omitted for production |
| `page` | integer | no | Page number from 1 (default 1) |
| `limit` | integer | no | Items per page, 1 to 100 (default 20) |

**Responses**

`200` OK

```json
{
  "environment": "sandbox",
  "payouts": [
    {
      "payoutId": "6b1f0d24-9c3a-4f18-b7e5-2a8c4d6e0f13",
      "environment": "sandbox",
      "status": "pending",
      "quoteId": "3f6c2a1e-8b4d-4c7a-9e2f-5d1b0a9c8e7f",
      "network": "PolygonTestAmoy",
      "cryptoCurrency": "USDC_TEST",
      "sourceAddress": "<the source wallet's address>",
      "deposit": {
        "address": "<the bank ramp's deposit address>",
        "amount": "10.3",
        "amountUnits": "10300000",
        "tokenAddress": "0xae1D7d8B36E9AbA7D95A75c69d50b38E7e02A9DD",
        "decimals": 6,
        "chainId": 80002,
        "expiresAt": "2026-09-17T13:00:00.000Z",
        "uri": "ethereum:0xae1D7d8B36E9AbA7D95A75c69d50b38E7e02A9DD@80002/transfer?address=<the bank ramp's deposit address>&uint256=10300000"
      },
      "cryptoAuthorizedAmount": "10.506",
      "cryptoAuthorizedAmountUnits": "10506000",
      "fiatCurrency": "EUR",
      "fiatAmount": "9.5",
      "rate": "0.95",
      "totalFee": "0.285",
      "quote": { "expiresAt": "2026-09-17T12:30:00.000Z" },
      "createdAt": "2026-09-17T12:02:00.000Z",
      "updatedAt": "2026-09-17T12:02:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}
```

`403` No tenant

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "This request needs a tenant: an admin token without one reads no payout."
}
```

---

Web version: https://docs.aureahub.com/#payout-wallet-list