---
title: "Get exchange transfers"
method: GET
path: "/exchange_transfers"
tags: ["Exchange transfers"]
---

# Get exchange transfers

`GET /exchange_transfers`

Gets all exchange transfers.

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Successfully retrieved exchange transfers.

- ExchangeTransfers — Provides a `content` array of exchange transfer objects and a set of pagination information fields.
  - `first` boolean — true if this is the first page.
  - `last` boolean — true if this is the last page.
  - `number` integer — page number
  - `numberOfElements` integer — Number Of elements in this request
  - `size` integer — page size
  - `totalElements` integer — Total number of elements for the given request
  - `totalPages` integer — Total number of pages for the given request
  - `sort` Sort[] — Sort details of this page
    - `direction` string — Direction of the sort
    - `property` string
    - `ignoreCase` boolean
    - `nullHandling` string
    - `ascending` boolean
    - `descending` boolean
  - `content` FiatExchangeTransferExecuteResponse[] — Provides an array of exchange transfer objects.
    - `exchange_transfer_id` string, uuid, required — Unique identifier of the exchange transfer.
    - `state` 'EXECUTED' | 'COMPLETED' | 'FAILED', required — State of the exchange transfer.
    - `type` 'FIRM' | 'INDICATIVE', required — Indicates the exchange transfer's quoted FX rate type.
    - `sender_address` string, required — RippleNet account name and address of the sender, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`.
    - `receiver_address` string, required — RippleNet account name and address of the receiver, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`.
    - `source_amount` number, required — Sending amount of the exchange transfer.
    - `destination_amount` number, required — Receiving amount of the exchange transfer.
    - `source_currency` string, required — Sending currency of the exchange transfer.
    - `destination_currency` string, required — Receiving currency of the exchange transfer.
    - `fx_transfer_rate` ExchangeTransferRate, required — Describes an exchange rate used in an exchange transfer.
      - `rate` number, required — Exchange rate used to make the exchange transfer.
      - `base_currency` string, required — Base currency for custom rate for the sending account.
      - `counter_currency` string, required — Counter currency for custom rate for the sending account.
      - `rate_type` string, required — Rate type used to make the exchange transfer. Valid values are `BUY` or `SELL`.
    - `end_to_end_id` string, required — ID set by the sender that is persisted on all fiat node instances that participated in the transfer.
    - `internal_id` string, required — Internal ID that the sender can optionally specify. Only visible to the sender. Only the sending fiat node instance stores this ID.
    - `user_info` FiatExchangeTransferUserInfo[], required — Custom information set by a RippleNet address involved in the exchange transfer.
      - `node_address` string, required — RippleNet address of the fiat node instance that set the user information.
      - `state` 'EXECUTED' | 'COMPLETED' | 'FAILED', required — State of the exchange transfer set when the RippleNet address set the user information.
      - `json` object, required — One or more arbitrary key/value pairs.
      - `created_at` string, date-time — timestamp of when this user info was created

## Other responses

- `400` — Bad request.

---

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