# List the Customer's Addresses

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

The addresses the user proved and still uses with the bank ramp in one environment, newest first.

## Overview

- `status`: `linked` (the bank ramp pays to it and takes from it on that chain), `pending` or `failed` (with `failureCode`).
- **A pending address is read again from the bank ramp first**: linked once the bank ramp lists it on the chain, still pending while it waits for the on-chain signature, otherwise `failed` with `BANK_RAMP_LINK_NOT_SIGNED`. If the bank ramp cannot be reached, the addresses are answered as Aurea keeps them.
- Revoked addresses are not listed. Answers whatever your tenant's settings; `403` to a token without a tenant.

## Endpoint

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

Authentication: bearer token required.

Lists the user's proven addresses 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
{
  "addresses": [
    {
      "addressId": "6c2e8a4f-0b1d-4f3a-9e7c-5d2b8f1a6c39",
      "address": "0xC0207704CaEB9342cf491Ad4a177F43592df65a7",
      "network": "gnosis",
      "environment": "sandbox",
      "proof": "eip191",
      "linkSignature": "eoa",
      "status": "linked",
      "failureCode": null,
      "verifiedAt": "2026-10-14T10:02:00.000Z",
      "linkedAt": "2026-10-14T10:02:01.000Z"
    }
  ]
}
```

---

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