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

# List transfers

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

## Path parameters

- `domainId` string, uuid, required

## Query parameters

- `limit` integer
- `startingAfter` string, uuid
- `sortBy` 'id' | 'transactionId' | 'tickerId' | 'quarantined' | 'value' | 'kind' | 'registeredAt'
- `sortOrder` 'ASC' | 'DESC'
- `transactionId` string, uuid
- `tickerId` string, uuid
- `quarantined` boolean
- `quarantineStatus` 'Quarantined' | 'Released' | 'Skipped'
- `kind` 'Transfer' | 'Fee' | 'Recovery'
- `accountId` string, uuid
- `recipient.accountId` string[]
- `registeredAt.lt` string, date-time
- `registeredAt.gt` string, date-time
- `recipient.addressDetails.address` string[]
- `ticker.ledgerId` string[]
- `ticker.validationStatus` 'Validated' | 'NonValidated'
- `ticker.lock` CoreLockStatus[]

## Response `200`

- CoreTransfersCollection
  - `items` CoreApiTransfer[], required
    - `id` string, uuid, required
    - `transactionId` string, uuid
    - `tickerId` string, uuid, required
    - `quarantined` boolean, required
    - `quarantineStatus` 'Quarantined' | 'Released' | 'Skipped'
    - `senders` CoreSenderTransferParty[], required
      - union
        - CoreSenderTransferPartyAccount
          - `domainId` string, uuid, required
          - `accountId` string, uuid, required
          - `addresses` string[]
          - `addressesDetails` CoreAddressDetails[]
            - `address` string, required
            - `resolvedEndpoints` CoreResolvedEndpoint[], required
              - …
          - `type` 'Account', required
        - CoreSenderTransferPartyAddress
          - `address` string, required
          - `addressDetails` CoreAddressDetails, required
            - `address` string, required
            - `resolvedEndpoints` CoreResolvedEndpoint[], required
              - …
          - `type` 'Address', required
    - `recipient` union
      - CoreRecipientTransferPartyAccount
        - `domainId` string, uuid, required
        - `accountId` string, uuid, required
        - `address` string
        - `addressDetails` CoreAddressDetails
          - `address` string, required
          - `resolvedEndpoints` CoreResolvedEndpoint[], required
            - `endpointId` string, uuid, required
            - `domainId` string, uuid, required
        - `type` 'Account', required
      - CoreRecipientTransferPartyAddress
        - `address` string, required
        - `addressDetails` CoreAddressDetails, required
          - `address` string, required
          - `resolvedEndpoints` CoreResolvedEndpoint[], required
            - `endpointId` string, uuid, required
            - `domainId` string, uuid, required
        - `type` 'Address', required
    - `value` 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.
    - `kind` 'Transfer' | 'Fee' | 'Recovery', required
    - `registeredAt` string, date-time, required
    - `metadata` union, required
      - CoreTransferMetadataAlgorand
        - `type` 'Algorand', required
      - CoreTransferMetadataBitcoin
        - `outputIndex` integer
        - `type` 'Bitcoin', required
      - CoreTransferMetadataCardano
        - `type` 'Cardano', required
      - CoreTransferMetadataEthereum
        - `type` 'Ethereum', required
      - CoreTransferMetadataHedera
        - `type` 'Hedera', required
      - CoreTransferMetadataSolana
        - `type` 'Solana', required
      - CoreTransferMetadataStellar
        - `type` 'Stellar', required
      - CoreTransferMetadataSubstrate
        - `type` 'Substrate', required
      - CoreTransferMetadataTezos
        - `type` 'Tezos', required
      - CoreTransferMetadataTron
        - `type` 'Tron', required
      - CoreTransferMetadataXRPL
        - `sourceTag` integer
        - `destinationTag` integer
        - `type` 'XRPL', required
  - `count` integer, required
  - `currentStartingAfter` string
  - `nextStartingAfter` string

## Other responses

- `400` — Invalid request (InvalidRequestError)
- `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)