---
title: "List bank accounts"
method: GET
path: "/v1/stablecoin/bank-accounts"
tags: ["Bank accounts"]
---

# List bank accounts

`GET /v1/stablecoin/bank-accounts`

## Request

- Base URL: `https://api.ripple.com`
- URL: `https://api.ripple.com/v1/stablecoin/bank-accounts`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.ripple.com/v2/oauth/token` scopes: `rlusd_customers:read`
- TypeScript: <https://skmtc.dev/ripple/apis/ripple-mint-api/docs/v1/stablecoin/bank-accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of the cash accounts registered against your stablecoin product,
including which one your `FIAT` redemptions settle to (`isRedemption`).

Account numbers and IBANs are served redacted to their last four characters. For the Ripple
account to wire *into* when buying, which is served in full, see
[Get bank details](#operation/getFiatBankDetails).

An account list with no rows returns an empty page with `200`, never a `404`.

## Query parameters

- `page` integer
- `size` integer
- `sort` string

## Response `200`

Paginated list of bank accounts

- BankAccountListResponse
  - `content` BankAccount[]
    - `name` string, required: Customer-supplied account name. An empty string when the account has none.
    - `bankName` string, required: An empty string when the account has none.
    - `accountNumberLastFour` string: Last four digits of the account number only.
    - `ibanLastFour` string: Last four characters of the IBAN only.
    - `swiftBicCode` string
    - `routingNumber` string
    - `currency` string: ISO-4217 currency code.
    - `reference` string: Payment reference to quote on transfers to this account.
    - `isRedemption` boolean, required: Whether this is the account your `FIAT` redemptions are paid out to.
  - `totalElements` integer: Total number of matching bank accounts
  - `totalPages` integer
  - `size` integer
  - `number` integer: Current page number (0-indexed)

## Other responses

- `401`: Missing or expired access token
- `403`: The caller is not entitled to the operation - either the access token lacks the scope the operation requires, or the tenant is not entitled to the API at all (`FORBIDDEN`).
- `500`: Unexpected server error
- `502`: An upstream system Ripple depends on could not be reached (`UPSTREAM_UNAVAILABLE`). Safe to retry: these are reads with no side effects, and the one write that returns it — `createFiatInstruction` — is idempotent on `id`.

## Changes

- **2026-09-18** `6db752579872`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ripple/apis/ripple-mint-api/changes/v1/stablecoin/bank-accounts/get.md)

---

[API](https://skmtc.dev/ripple/apis/ripple-mint-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-mint-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-mint-api/revisions/6db752579872?raw)