---
title: "List wallets"
method: GET
path: "/v1/stablecoin/wallets"
tags: ["Wallets"]
---

# List wallets

`GET /v1/stablecoin/wallets`

## Request

- Base URL: `https://api.ripple.com`
- URL: `https://api.ripple.com/v1/stablecoin/wallets`
- 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/wallets/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of the wallets registered for your tenant. This is the `ripId`
lookup: use it to resolve the `walletRipId` you quote on a fiat buy instruction or a bridge
approval, and to map a `walletRipId` on a transaction leg back to an address and chain.

A `ripId` that matches nothing returns an empty page with `200`, never a `404`.

## Query parameters

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

## Response `200`

Paginated list of wallets

- WalletListResponse
  - `content` Wallet[]
    - `ripId` string, required: The wallet ripId as you know it in Ripple Home, e.g. `RIP0000001`. This is the value you quote as `walletRipId` elsewhere in this API.
    - `nickname` string: Customer-supplied nickname. Omitted when the wallet has none.
    - `address` string, required: On-chain address. EVM addresses carry the `0x` prefix; XRPL addresses do not.
    - `destinationTag` integer: XRPL destination tag. Omitted when the wallet has none.
    - `chain` string, required: Network the wallet lives on. These are the fuller mainnet identifiers - e.g. `XRPL_MAINNET`, `ETH_MAINNET` - rather than the shorter `XRPL` / `ETH` values the Transaction API returns, so join wallets to transactions on `ripId` / `walletRipId`, never on `chain`.
    - `status` 'PENDING_APPROVAL' | 'APPROVED' | 'DENIED', required: Approval status. Only an `APPROVED` wallet can receive minted RLUSD.
    - `createdAt` string, date-time, required
  - `totalElements` integer: Total number of matching wallets
  - `totalPages` integer
  - `size` integer
  - `number` integer: Current page number (0-indexed)

## Other responses

- `400`: The `ripId` is not a valid wallet ripId (`INVALID_REQUEST_BODY`).
- `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/wallets/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)