get_account_payments: Payment History

Description Usage Arguments Details Value

View source: R/get_account_payments.R

Description

This API endpoint can be used to browse through an account's payment history and also used to confirm specific payments after a payment has been submitted.

Usage

1
2
3
get_account_payments(address, source_account, destination_account,
  exclude_failed = FALSE, direction, earliest_first = FALSE, start_ledger,
  end_ledger, results_per_page = 10, page = 1)

Arguments

address

The Ripple address of the desired account

source_account

Filter the results to only include payments sent by the given account.

destination_account

Filter the results to only include payments received by the given account.

exclude_failed

If set to TRUE, the results will only include payments which were successfully validated and written into the ledger. Otherwise, failed payments will be included. Defaults to FALSE.

direction

Limit the results to only include the given type of payments. The following direction values are currently supported: incoming, outgoing, pending

earliest_first

If set to TRUE, the payments will be returned in ascending date order. Otherwise, the payments will be returned in descending date order (ie, the most recent payment will be returned first). Defaults to FALSE.

start_ledger

The index for the starting ledger. If earliest_first is TRUE, this will be the oldest ledger to be queried; otherwise, it will be the most recent ledger. Defaults to the first ledger in the rippled server's database.

end_ledger

The index for the ending ledger. If earliest_first is TRUE, this will be the most recent ledger to be queried; otherwise, it will be the oldest ledger. Defaults to the most recent ledger in the rippled server's database.

results_per_page

The maximum number of payments to be returned at once. Defaults to 10.

page

The page number to be returned. The first page of results will have page number 1, the second page will have page number 2, and so on. Defaults to 1.

Details

If the server returns fewer than results_per_page payments, then there are no more pages of results to be returned. Otherwise, increment the page number and re-issue the query to get the next page of results.

Note that the Ripple-REST API has to retrieve the full list of payments from the server and then filter them before returning them back to the caller. This means that there is no speed advantage to specifying more filter values.

Value

A list of objects of class "Payment"


hmalmedal/ripplerestr documentation built on May 17, 2019, 4:34 p.m.