---
title: "List transactions"
method: GET
path: "/v1/domains/{domainId}/transactions"
tags: ["Transactions"]
---

# List transactions

`GET /v1/domains/{domainId}/transactions`

## Path parameters

- `domainId` string, uuid, required

## Query parameters

- `limit` integer
- `startingAfter` string, uuid
- `sortBy` 'id' | 'ledgerId' | 'processingStatus' | 'registeredAt' | 'ledgerTransactionData.ledgerStatus' | 'ledgerTransactionData.statusLastUpdatedAt'
- `sortOrder` 'ASC' | 'DESC'
- `ledgerId` string
- `orderReference.Id` string, uuid
- `orderReference.domainId` string, uuid
- `accountId` string, uuid
- `processing.status` 'Pending' | 'Preparing' | 'Reserved' | 'Prepared' | 'Broadcasting' | 'Completed' | 'Interrupted' | 'Failed'
- `ledgerTransactionData.ledgerStatus` 'Detected' | 'Confirmed' | 'Expired' | 'Replaced'
- `ledgerTransactionData.ledgerTransactionId` string

## Response `200`

- CoreTransactionsCollection
  - `items` CoreApiTransaction[], required
    - `id` string, uuid, required
    - `ledgerId` string, required
    - `orderReference` CoreTransactionOrderReference
      - `id` string, uuid, required
      - `domainId` string, uuid, required
    - `relatedAccounts` CoreTransactionRelatedAccountReference[], required
      - `id` string, uuid, required
      - `domainId` string, uuid, required
      - `sender` boolean, required
    - `processing` union
      - CoreApiTransactionProcessingDetailsBroadcasting
        - `hint` 'CurrentlyFeesTooSmall' | 'CurrentlyRejectedByLedger' | 'InternalError' | 'TransientIssue'
        - `status` 'Broadcasting', required
      - CoreApiTransactionProcessingDetailsCompleted
        - `status` 'Completed', required
      - CoreApiTransactionProcessingDetailsFailed
        - `hint` 'AccountAlreadyActivatedOnLedger' | 'BroadcastExpired' | 'InternalError' | 'InvalidAccountStateOnLedger' | 'InvalidAmount' | 'InvalidContractParameters' | 'InvalidDestination' | 'InvalidUserPayload' | 'LockedDestination' | 'OnLedgerFailure' | 'ReplacementTransactionFeesTooLow' | 'TransactionNotEligibleForReplacement' | 'TransactionRejected' | 'TransientIssue', required
        - `status` 'Failed', required
      - CoreApiTransactionProcessingDetailsInterrupted
        - `reason` string, required
        - `cause` 'Cancellation' | 'Internal' | 'Replacement', required
        - `status` 'Interrupted', required
      - CoreApiTransactionProcessingDetailsPending
        - `hint` 'InternalError' | 'TransientIssue'
        - `status` 'Pending', required
      - CoreApiTransactionProcessingDetailsPrepared
        - `status` 'Prepared', required
      - CoreApiTransactionProcessingDetailsPreparing
        - `hint` 'AccountAlreadyActivatedOnLedger' | 'AccountNotReadyOnLedger' | 'CurrentlyFeesTooLarge' | 'CurrentlyFeesTooSmall' | 'CurrentlyFundsTooFragmented' | 'CurrentlyNotEnoughFunds' | 'CurrentlyUnusableDestination' | 'InternalError' | 'InvalidAccountStateOnLedger' | 'InvalidContractParameters' | 'InvalidDestination' | 'OnLedgerFailure' | 'TransactionEstimationFailure' | 'TransientIssue'
        - `status` 'Preparing', required
      - CoreApiTransactionProcessingDetailsReserved
        - `status` 'Reserved', required
    - `registeredAt` string, date-time, required
    - `ledgerTransactionData` CoreLedgerTransactionData
      - `ledgerStatus` 'Detected' | 'Confirmed' | 'Expired' | 'Replaced', required
      - `failure` 'FailedOnChain' | 'PartiallyFailedOnChain'
      - `ledgerTransactionId` string, required
      - `rawTransaction` string
      - `blockTime` string, date-time
      - `statusLastUpdatedAt` string, date-time, required
      - `providerStatusLastUpdatedAt` string, date-time
      - `ledgerData` union
        - CoreOnLedgerDataBitcoin
          - `inputs` CoreBitcoinOnLedgerDataInput[], required
            - `accountReference` CoreAccountReference
              - …
            - `address` string
            - `index` integer, required
            - `scriptPubKey` string
            - `transactionHash` string
          - `outputs` CoreBitcoinOnLedgerDataOutput[], required
            - `accountReference` CoreAccountReference
              - …
            - `address` string
            - `amount` string, required — This field is a large integer that can be positive or zero. It is represented as a string because it may contain value that cannot be expressed with JSON number without a loss of precision.
            - `index` integer, required
            - `scriptPubKey` string, required
          - `type` 'Bitcoin', required
        - CoreOnLedgerDataEthereum
          - `logs` CoreEthereumLedgerLog[], required
            - `logIndex` string, required — This field is a large integer and represented as a string because it may contain value that cannot be expressed with JSON number without a loss of precision.
            - `address` string, required
            - `data` string, required
            - `topics` string[], required
          - `createdContractAddresses` string[]
          - `deletedContractAddresses` string[]
          - `type` 'Ethereum', required
        - CoreOnLedgerDataXrpl
          - `tokenData` CoreXrplOnLedgerTokenData
            - `issuanceId` string, required — XRPL MPToken Issuance ID (192-bit integer hex encoded)
          - `type` 'Xrpl', required
  - `count` integer, required
  - `currentStartingAfter` string
  - `nextStartingAfter` string

## Other responses

- `400` — Invalid value for: path parameter domainId, Invalid value for: query parameter limit, Invalid value for: query parameter startingAfter, Invalid value for: query parameter sortBy, Invalid value for: query parameter sortOrder, Invalid value for: query parameter ledgerId, Invalid value for: query parameter orderReference.Id, Invalid value for: query parameter orderReference.domainId, Invalid value for: query parameter accountId, Invalid value for: query parameter processing.status, Invalid value for: query parameter ledgerTransactionData.ledgerStatus, Invalid value for: query parameter ledgerTransactionData.ledgerTransactionId
- `401` — One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)
- `404` — Entity or Domain not found (EntityNotFoundError)

---

[API](https://skmtc.net/ripple/apis/ripple-custody-api.md) · [All operations](https://skmtc.net/ripple/apis/ripple-custody-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripple-custody-api/revisions/410038300d74/schema)