Skip to content

Use these operations to manage your transfers.

OperationMethodDescription
Get transfersGETGets a list of transfers.
Get transfer estimateGETGet an estimate of the fee to make an "outbound" transfer from an exchange (connected to xRapid) to an another account outside of RippleNet (such as a bank account).
Get transfer by IDGETGets a transfer by ID.
Execute transferPOSTTransfers funds between accounts.
Complete transferPOSTUpdates the state of a transfer to COMPLETED.
Add transfer labelsPUTAdds a list of labels to the transfer. To retrieve transfers by label, see Get transfers
Delete transfer labelsDELETEDeletes one or more existing labels from the transfer.

Get transfers

Request

Gets a list of transfers.

Security
Bearer
Query
pageinteger

The page number for paginated results. The value is zero-based, where 0 represents the first page.
Set it to 0 to get the first page of results.

Default:0
sizeinteger, [ 1 .. 100 ]

Number of objects to return per page.

Default:20
with_labelsArray of strings

Returns transfers that contain any of the specified labels.

Example - ?with_labels=LABEL1,LABEL2

without_labelsArray of strings

Returns transfers that do not contain any of the specified labels.

include_labelsboolean

Returns labels added to each Transfer object. By default labels are not returned.

Example - ?with_labels=LABEL1&include_labels=true

Default:false
statestring

Filter by transfer states.

Enum:"PREPARED""EXECUTED""COMPLETED""FAILED""PENDING"
internal_idstring

Optional parameter for filtering with internalId.

sender_end_to_end_idstring

Optional parameter for filtering with sender end to end id.

sort_fieldstring

Field used to sort the results.

Enum:"CREATED_AT""MODIFIED_AT"
sort_directionstring

Sort direction.

Enum:"ASC""DESC"
accountstring

RippleNet account which is involved in transfer

transfer_account_rolestring

by default account parameter would search both sender and receiver of transfer and bring the results. This is to restrict the account search to sender or receiver of a transfer

Enum:"SENDING""RECEIVING"
curl -i -X GET \
  'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/transfers?page=0&size=20&with_labels=string&without_labels=string&include_labels=false&state=PREPARED&internal_id=string&sender_end_to_end_id=string&sort_field=CREATED_AT&sort_direction=ASC&account=string&transfer_account_role=SENDING' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully returned transfers.

Bodyapplication/json
firstboolean

true if this is the first page.

lastboolean

true if this is the last page.

numberinteger

page number

numberOfElementsinteger

Number Of elements in this request

sizeinteger

page size

totalElementsinteger, (int64)

Total number of elements for the given request

totalPagesinteger

Total number of pages for the given request

sortArray of objects

Sort details of this page

contentArray of objects

Provides an array of transfer objects.

Response
{ "first": true, "last": true, "number": 0, "numberOfElements": 0, "size": 0, "totalElements": 0, "totalPages": 0, "sort": [ { … } ], "content": [ { … } ] }