# List transactions

Returns a paginated list of transactions, optionally filtered by type and status.

Endpoint: GET /v1/stablecoin/transactions
Version: 1.0.0
Security: oauth2

## Query parameters:

  - `transactionTypes` (array)
    Filter by transaction type. Repeatable.
    Enum: "ISSUANCE", "REDEMPTION", "BRIDGE"

  - `statuses` (array)
    Filter by status. Repeatable.
    Enum: "PROCESSING", "COMPLETED", "FAILED", "CANCELED"

  - `page` (integer)
    Page number, 0-indexed (default 0)

  - `size` (integer)
    Page size (default 20)

  - `sort` (string)
    Sort field and direction (default: updatedAt,desc).
Supported fields: updatedAt, createdAt, type, status, amount.

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (string, required)
    Unique transaction identifier

  - `content.type` (string, required)
    Transaction type.
    Enum: "ISSUANCE", "REDEMPTION", "BRIDGE"

  - `content.status` (string, required)
    Current transaction status. COMPLETED, FAILED, and CANCELED are terminal.
CANCELED currently applies to ISSUANCE transactions canceled before settlement.
    Enum: "PROCESSING", "COMPLETED", "FAILED", "CANCELED"

  - `content.amount` (string, required)
    Transaction amount as a decimal string (e.g. "10000.00")

  - `content.token` (string, required)
    Always RLUSD
    Enum: "RLUSD"

  - `content.source` (object, required)

  - `content.source.type` (string, required)
    Endpoint type
    Enum: "FIAT", "CRYPTO"

  - `content.source.walletId` (string,null)
    Wallet identifier (e.g. RIP0000001). Present when type is CRYPTO.

  - `content.source.address` (string,null)
    The customer's on-chain address on this leg. Present when type is CRYPTO
and the on-chain leg has been initiated. EVM addresses include the 0x prefix.

  - `content.source.chain` (string,null)
    Blockchain network name (e.g. XRPL, ETH). Present when type is CRYPTO.

  - `content.source.transactionHash` (string,null)
    On-chain transaction hash for this leg. Present when the on-chain leg has settled.
EVM chains (e.g. ETH) return the hash with the 0x prefix; XRPL hashes are
uppercase hex without a prefix.

  - `content.source.counterpartyAddress` (string,null)
    The Ripple-side internal account address that participated in this on-chain leg
(the counterparty to your wallet). Present when type is CRYPTO and the on-chain leg
has been initiated. EVM addresses include the 0x prefix.

  - `content.destination` (object, required)

  - `content.createdAt` (string, required)
    Timestamp when the transaction was created

  - `content.updatedAt` (string, required)
    Timestamp when the transaction was last updated

  - `totalElements` (integer)
    Total number of matching transactions

  - `totalPages` (integer)
    Total number of pages

  - `size` (integer)
    Page size

  - `number` (integer)
    Current page number (0-indexed)

## Response 400 fields (application/problem+json):

  - `type` (string)
    URI reference identifying the problem type

  - `title` (string)
    Short, human-readable summary of the problem

  - `status` (integer)
    HTTP status code

  - `code` (string)
    Machine-readable error code
    Enum: "TRANSACTION_NOT_FOUND", "INVALID_REQUEST_BODY", "UNKNOWN_EXCEPTION"