# Get a Wallet Payout

Read one payout paid from the user's own wallet, as Aurea keeps it, without asking the bank ramp.

## Overview

- Answers the same shape as [Pay Out a Quote from Your Wallet](https://docs.aureahub.com/docs/payout-wallet-pay.md), with `status` and `updatedAt` as they stand now.
- **This is what you call after an unknown outcome.** `deposit.address` is `null` while Aurea does not know the bank ramp's answer: the user must not send anything yet.
- Only the user's own wallet payouts, in the environment named by `isTestnet`. An unknown id, another user's or another tenant's payout, one of the other environment, and a hosted checkout payout of [Initiate Payout](https://docs.aureahub.com/docs/payout-initiate.md) all answer `404` `NOAH_PAYOUT_NOT_FOUND` with `details.environment`.
- It needs a tenant (`403` otherwise) and nothing else, so a payout stays readable after payouts are switched off. `payoutId` that is not a UUID answers `400`. The bank ramp is not called.

## Endpoint

### `GET /v1/ramp/bank/payout/payouts/{payoutId}`

Authentication: bearer token required.

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

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `payoutId` | string | yes | The payout's id (UUID) |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the bank ramp's sandbox; `false` or omitted for production |

**Responses**

`200` Outcome unknown

```json
{
  "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": null,
    "amount": "10.3",
    "amountUnits": "10300000",
    "tokenAddress": "0xae1D7d8B36E9AbA7D95A75c69d50b38E7e02A9DD",
    "decimals": 6,
    "chainId": 80002,
    "expiresAt": "2026-09-17T13:00:00.000Z",
    "uri": null
  },
  "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"
}
```

`404` Not the user's

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No payout with this id for you in sandbox.",
  "details": { "code": "NOAH_PAYOUT_NOT_FOUND", "environment": "sandbox" }
}
```

---

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