# List Wallet Links

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

The user's Aurea wallets linked, or being linked, to their bank ramp customer in one environment, newest first.

## Overview

- Each link as [Link a Wallet](https://docs.aureahub.com/docs/bank-customer-wallet-link.md) answers it: `status` `awaiting_signature`, `pending`, `linked`, `failed` (with `failureCode`) or `expired`.
- Aurea keeps the message, its digest, the wallet, the chain and who signed — never a signature or a key.
- Answers whatever your tenant's settings; `403` to a token without a tenant.

## Endpoint

### `GET /v1/ramp/bank/customer/wallets`

Authentication: bearer token required.

Lists the user's wallet links in one environment.

**Query parameters**

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

**Responses**

`200` OK

```json
{
  "links": [
    {
      "linkId": "9e3b6a1f-4c2d-4e8b-a7f0-5d1c3b9e2a64",
      "walletId": "0b7d2e4f-6a8c-4e1b-9d3f-2c5a7e9b1d40",
      "address": "0xC0207704CaEB9342cf491Ad4a177F43592df65a7",
      "network": "gnosis",
      "environment": "sandbox",
      "signer": "client",
      "status": "linked",
      "message": null,
      "digest": null,
      "expiresAt": null,
      "failureCode": null,
      "linkedAt": "2026-10-14T09:31:10.000Z",
      "createdAt": "2026-10-14T09:30:00.000Z"
    }
  ]
}
```

---

Web version: https://docs.aureahub.com/#bank-customer-wallets