---
title: "Execute transfer"
method: POST
path: "/transfers/execute"
tags: ["Transfers"]
---

# Execute transfer

`POST /transfers/execute`

Transfers funds between accounts. For example, use this request to fund a connector account by transferring funds from a transactional account to the connector account. You can also use this request to redeem funds to a transactional account by transferring funds from a connector account to the transactional account.

## Request body

- TransferRequest — Use this JSON request body to execute a transfer.
  - `sender_address` string, required — RippleNet account name and address, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`.
  - `receiver_address` string, required — RippleNet account name and address, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`.
  - `amount` number, required — Amount transferred, expressed in the account's currency.
  - `owner_address` string — Owner RippleNet address, if different from the RippleNet address of the `sender_address` and `receiver_address`.
  - `end_to_end_id` string — ID set by the sender that is persisted on all xCurrent instances that participated in the transfer.
  - `internal_id` string — ID set by the sender that is persisted on the sending xCurrent instance only.
  - `user_info` object — Provide one or more arbitrary key/value pairs.

## Response `200`

Successfully executed transfer.

- TransferResponse — JSON response object representing a transfer.
  - `transfer_id` string, uuid, required — Unique identifier of the transfer.
  - `state` 'PREPARED' | 'EXECUTED' | 'COMPLETED' | 'CANCELLED' | 'FAILED' | 'QUOTED' | 'PENDING' | 'OTHER', required — State of the transfer.<p>`QUOTED` and `PENDING` only apply when RippleNet is enabled to receive payments from xRapid. `QUOTED` represents an outbound transfer fee estimate. `PENDING` is the state of an outbound transfer executed by RippleNet (via xRapid) but not yet paid out by the digital exchange. If successfully paid out, the state becomes `COMPLETED`. If not successfully paid out by the digital exchange, the state becomes `FAILED`. </p>
  - `owner_address` string, required — Owner RippleNet address, if different from the RippleNet address of the `sender_address` and `receiver_address`.
  - `sender_address` string, required — RippleNet account name and address, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`.
  - `receiver_address` string, required — RippleNet account name and address, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`.
  - `amount` number, required — Amount transferred, expressed in the account's currency.
  - `internal_id` string — Internal ID that the sender can optionally specify. Only visible to the sender. Only the sending RippleNet instance stores this ID.
  - `end_to_end_id` string — ID that the sender can optionally specify. Persisted on all RippleNet instances that participated in the transfer.
  - `sending_fee` number — Optional sending fee charged by a digital asset exchange for initiating an outbound transfer.
  - `created_at` string, date-time — The time when this transfer is created.
  - `user_info` TransferUserInfo[], required — Custom information set by a RippleNet address involved in the transfer.
    - `node_address` string, required — RippleNet address of the xCurrent instance that set the user information.
    - `state` 'PREPARED' | 'EXECUTED' | 'COMPLETED' | 'CANCELLED' | 'FAILED' | 'QUOTED', required — State of the 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
  - `labels` string[] — List of labels associated with this transfer

## 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)