RippleNet Server API (4.0.0)

The RippleNet Server API provides you the ability to develop custom applications to manage or interact with your RippleNet instance.

Check out the best practices and tutorials.

Authentication

All API operations require a bearer access token for your target environment.<br>Learn how to request the access token.

API environments

The RippleNet Server API creates a dynamic [domainPrefix] that consists of {tenant}.{environment}.

Note: This example uses aperture as the tenant. Your tenant ID is different.

Environment	Domaing Prefix	Domain	Base URL
Test	`aperture.test`	`ripplexcurrent.com`	`https://aperture.test.ripplexcurrent.com`
UAT	`aperture.uat`	`ripplexcurrent.com`	`https://aperture.uat.ripplexcurrent.com`
Production	`aperture.prod`	`ripplexcurrent.com`	`https://aperture.prod.ripplexcurrent.com`

Servers

Mock server

https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/

https://[domainPrefix].ripplexcurrent.com/v4/

Auditing

Use these operations to audit your accounts.

Operation	Method	Description
Get audits	GET	Gets an audit trail of user actions and configuration changes (to accounts, fees, and rates) on a RippleNet instance.
Get event trail for payment	GET	Gets an audit trail of a payment's state changes on a local RippleNet instance.

Operations

Balances and statements

Use these operations to view balances and statements for a ledger.

Operation	Method	Description
Get balances	GET	Get balances for local and remote accounts owned by a RippleNet address.
Get ledger balances	GET	Get balances for ledger owned by a RippleNet address.
Get statement	GET	Gets a statement for an account that lists payments and transfers that impacted the account's balance during a specified date-time range.
Get statement by external account ID	GET	Gets a statement for an account that lists payments and transfers that impacted the account's balance during a specified date-time range.
Get ledger account statement	GET	Get statement for a specified Ledger Account

Operations

Get balances

Request

Get balances for local and remote accounts owned by a RippleNet address.

Security

Bearer

curl -i -X GET \
  https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/monitor/balances \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully returned balances.

Bodyapplication/json

local_balanceArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address.

institutionstringrequired

RippleNet unique internal ID of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

institution_addressstringrequired

RippleNet address of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

currency_balancesArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address. The response does not guarantee a fixed number of elements, or a fixed order of elements, in the returned list.

currencystringrequired

Currency of the balances provided.

Example: "USD"

aggregate_balancenumberrequired

Aggregated balance for the given currrency.

Example: 0

account_balancesArray of objectsrequired

Provides balance details for accounts that support the given currency.

account_namestring

Name of the account, which acts as the account's unique identifier on RippleNet.

Example: "trans_usd_sf"

balancenumber

Balance available in the account.

Example: -909

ownerstring

RippleNet address of the owner of the account.

Example: "rn.us.ca.san_francisco"

currencystring

Currency supported by the account.

Example: "USD"

minimum_allowed_balancenumber

Minimum balance allowed for the account.

Example: -1500000

maximum_allowed_balancenumber

Maximum balance allowed for the account.

Example: 1000000

low_liquidity_thresholdnumber

When the balance value for a sender account meets or is less than this amount after payment settlement execution, a low-liquidity message is logged at the INFO level.

Example: 1000

owner_min_allowed_balancenumber

Minimum balance allowed by the owner of a nostro account. RippleNet Server uses the greater of this value and the minimum_allowed_balance to set the account balance minimum.

owner_max_allowed_balancenumber

Maximum balance allowed by the owner of a nostro account. RippleNet Server uses the lesser of this value and the maximum_allowed_balance to set the account balance maximum.

Example: 1000000

pool_account_balancesArray of objects

Provides balance details of pool accounts, along with RippleNet accounts linked to those pool accounts.

pool_account_namestring

Name of the pool account.

balancenumber

Aggregated balance of linked accounts which form this pool account.

ownerstring

The RippleNet peer who owns this pool account.

currencystring

The currency of pool account.

linked_accountsArray of strings

Accounts linked to this pool account.

remote_balancesArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address.

institutionstringrequired

RippleNet unique internal ID of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

institution_addressstringrequired

RippleNet address of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

currency_balancesArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address. The response does not guarantee a fixed number of elements, or a fixed order of elements, in the returned list.

currencystringrequired

Currency of the balances provided.

Example: "USD"

aggregate_balancenumberrequired

Aggregated balance for the given currrency.

Example: 0

account_balancesArray of objectsrequired

Provides balance details for accounts that support the given currency.

account_namestring

Name of the account, which acts as the account's unique identifier on RippleNet.

Example: "trans_usd_sf"

balancenumber

Balance available in the account.

Example: -909

ownerstring

RippleNet address of the owner of the account.

Example: "rn.us.ca.san_francisco"

currencystring

Currency supported by the account.

Example: "USD"

minimum_allowed_balancenumber

Minimum balance allowed for the account.

Example: -1500000

maximum_allowed_balancenumber

Maximum balance allowed for the account.

Example: 1000000

low_liquidity_thresholdnumber

When the balance value for a sender account meets or is less than this amount after payment settlement execution, a low-liquidity message is logged at the INFO level.

Example: 1000

owner_min_allowed_balancenumber

Minimum balance allowed by the owner of a nostro account. RippleNet Server uses the greater of this value and the minimum_allowed_balance to set the account balance minimum.

owner_max_allowed_balancenumber

Maximum balance allowed by the owner of a nostro account. RippleNet Server uses the lesser of this value and the maximum_allowed_balance to set the account balance maximum.

Example: 1000000

pool_account_balancesArray of objects

Provides balance details of pool accounts, along with RippleNet accounts linked to those pool accounts.

pool_account_namestring

Name of the pool account.

balancenumber

Aggregated balance of linked accounts which form this pool account.

ownerstring

The RippleNet peer who owns this pool account.

currencystring

The currency of pool account.

linked_accountsArray of strings

Accounts linked to this pool account.

errorsArray of stringsrequired

Lists any errors encountered when returning balance details.

Response

application/json

{
  "local_balance": [
    { … }
  ],
  "remote_balances": [
    { … }
  ],
  "errors": [
    "string"
  ]
}

Get ledger balances

Request

Get balances for ledger owned by a RippleNet address.

Security

Bearer

curl -i -X GET \
  https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/monitor/ledger/balances \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully returned balances.

Bodyapplication/json

local_balanceArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address.

institutionstringrequired

RippleNet unique internal ID of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

institution_addressstringrequired

RippleNet address of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

currency_balancesArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address. The response does not guarantee a fixed number of elements, or a fixed order of elements, in the returned list.

currencystringrequired

Currency of the balances provided.

Example: "USD"

aggregate_balancenumberrequired

Aggregated balance for the given currrency.

Example: 0

account_balancesArray of objectsrequired

Provides balance details for accounts that support the given currency.

account_namestring

Name of the account, which acts as the account's unique identifier on RippleNet.

Example: "trans_usd_sf"

balancenumber

Balance available in the account.

Example: -909

ownerstring

RippleNet address of the owner of the account.

Example: "rn.us.ca.san_francisco"

currencystring

Currency supported by the account.

Example: "USD"

minimum_allowed_balancenumber

Minimum balance allowed for the account.

Example: -1500000

maximum_allowed_balancenumber

Maximum balance allowed for the account.

Example: 1000000

low_liquidity_thresholdnumber

When the balance value for a sender account meets or is less than this amount after payment settlement execution, a low-liquidity message is logged at the INFO level.

Example: 1000

owner_min_allowed_balancenumber

Minimum balance allowed by the owner of a nostro account. RippleNet Server uses the greater of this value and the minimum_allowed_balance to set the account balance minimum.

owner_max_allowed_balancenumber

Maximum balance allowed by the owner of a nostro account. RippleNet Server uses the lesser of this value and the maximum_allowed_balance to set the account balance maximum.

Example: 1000000

pool_account_balancesArray of objects

Provides balance details of pool accounts, along with RippleNet accounts linked to those pool accounts.

pool_account_namestring

Name of the pool account.

balancenumber

Aggregated balance of linked accounts which form this pool account.

ownerstring

The RippleNet peer who owns this pool account.

currencystring

The currency of pool account.

linked_accountsArray of strings

Accounts linked to this pool account.

remote_balancesArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address.

institutionstringrequired

RippleNet unique internal ID of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

institution_addressstringrequired

RippleNet address of the institution that owns the balances provided in the currency_balances array.

Example: "rn.us.ca.san_francisco"

currency_balancesArray of objectsrequired

Provides balance details for accounts owned by a RippleNet address. The response does not guarantee a fixed number of elements, or a fixed order of elements, in the returned list.

currencystringrequired

Currency of the balances provided.

Example: "USD"

aggregate_balancenumberrequired

Aggregated balance for the given currrency.

Example: 0

account_balancesArray of objectsrequired

Provides balance details for accounts that support the given currency.

account_namestring

Name of the account, which acts as the account's unique identifier on RippleNet.

Example: "trans_usd_sf"

balancenumber

Balance available in the account.

Example: -909

ownerstring

RippleNet address of the owner of the account.

Example: "rn.us.ca.san_francisco"

currencystring

Currency supported by the account.

Example: "USD"

minimum_allowed_balancenumber

Minimum balance allowed for the account.

Example: -1500000

maximum_allowed_balancenumber

Maximum balance allowed for the account.

Example: 1000000

low_liquidity_thresholdnumber

When the balance value for a sender account meets or is less than this amount after payment settlement execution, a low-liquidity message is logged at the INFO level.

Example: 1000

owner_min_allowed_balancenumber

Minimum balance allowed by the owner of a nostro account. RippleNet Server uses the greater of this value and the minimum_allowed_balance to set the account balance minimum.

owner_max_allowed_balancenumber

Maximum balance allowed by the owner of a nostro account. RippleNet Server uses the lesser of this value and the maximum_allowed_balance to set the account balance maximum.

Example: 1000000

pool_account_balancesArray of objects

Provides balance details of pool accounts, along with RippleNet accounts linked to those pool accounts.

pool_account_namestring

Name of the pool account.

balancenumber

Aggregated balance of linked accounts which form this pool account.

ownerstring

The RippleNet peer who owns this pool account.

currencystring

The currency of pool account.

linked_accountsArray of strings

Accounts linked to this pool account.

errorsArray of stringsrequired

Lists any errors encountered when returning balance details.

Response

application/json

{
  "local_balance": [
    { … }
  ],
  "remote_balances": [
    { … }
  ],
  "errors": [
    "string"
  ]
}

Get statement

Request

Gets a statement for an account that lists payments and transfers that impacted the account's balance during a specified date-time range.

Security

Bearer

Path

account_name_with_addressstringrequired

The RippleNet account name and address that you want to return a statement for. Use the format accountname@ripplenetaddress. For example, san_francisco@rn.us.ca.san_francisco.

Query

start-datestringrequired

The lower bound of the date-time range you want to return statement information for, as an ISO-8601 timestamp in UTC. For example, 2018-08-06T23:13:55.997Z.

end-datestringrequired

The upper bound of the date-time range you want to return statement information for, as an ISO-8601 timestamp in UTC For example, 2018-08-06T23:15:13.218Z.

pageinteger

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

Default 0

sizeinteger[ 1 .. 100 ]

Number of payment and transfer objects to return per page, with a limit of 100 per page.

For example, a query with "size": "100" results in "totalPages": "43" when the query result is "totalElements": "4290".

Default 10

curl -i -X GET \
  'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/statement/{account_name_with_address}?start-date=string&end-date=string&page=0&size=10' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully returns an account statement.

Bodyapplication/json

account_namestringrequired

Name of the account the statement covers.

Example: "trans_usd_sf"

start_datetimestring(date-time)required

Lower bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.

Example: "2018-08-06T23:13:55.997Z"

end_datetimestring(date-time)required

Upper bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.

Example: "2020-08-06T23:13:55.997Z"

generated_atstring(date-time)required

Time at which the statement was generated, as an ISO-8601 timestamp in UTC.

Example: "2019-10-01T21:58:23.621Z"

currencystringrequired

Currency supported by the account.

Example: "USD"

ownerstringrequired

Owner of the account

Example: "rn.us.ca.san_francisco"

opening_balancenumberrequired

Opening balance of the account for the given date range.

Example: 0

closing_balancenumberrequired

Closing balance of the account for the given date range.

Example: -909

transactionsobjectrequired

Provides a content array of statement record objects and a set of pagination information fields.

contentArray of objectsrequired

Provides an array of statement record objects.

transaction_idstring(uuid)required

ID of the payment or transfer that caused an account balance change.

Example: "9eca588f-e89d-4629-82fa-da9c4646310f"

transaction_typestringrequired

Type of transaction that caused an account balance change.

Enum"PAYMENT""TRANSFER""EXCHANGE_TRANSFER"

Example: "PAYMENT"

transaction_statestringrequired

Current state of the payment or transfer.

Example: "COMPLETED"

balance_changenumberrequired

Account balance change caused by the transaction.

Example: -15

balance_resultnumberrequired

Account balance after the transaction.

Example: -909

created_atstring(date-time)required

Time at which the transaction was created, as an ISO-8601 timestamp in UTC.

Example: "2019-10-01T21:28:28.354Z"

end_to_end_idstringrequired

ID that the sender of a transaction can specify. Persisted on all xCurrent instances that participated in the transaction.

Example: "91ecb6bd-4dd8-4b53-a900-72b79f3064e4"

internal_idstringrequired

Internal identifier that the sender can optionally specify. Only visible to the sender. Only the sending xCurrent instance stores this ID.

Example: "8afd8e99-4ad4-4f4e-9bb7-018ad8c3a89c"

venue_idstring

The id from an exchange associated with a transaction involving an exchange account.

Example: "nz7RpAujYgnQtjEM"

transaction_hashstring

Hash representing the unique identifier for the transfer of funds in the XRP ledger.

Example: "DB0AFC09E0A94FC1D11F8CBABA48A184E27094F8DD32FCBC46F316E98011E2A6"

returns_payment_with_idstring(uuid)required

The payment_id of the original payment that this payment returns, if this is a returned payment. Always set to null if the transaction_type is set to TRANSFER.

returned_by_payment_with_idstring(uuid)required

The payment_id of the return payment that returned this payment, if this is a returned payment. Always set to null if the transaction_type is set to TRANSFER.

balance_change_created_atstring(date-time)

Timestamp of when the balance change was created

Example: "2019-10-01T21:28:28.354Z"

sender_addressstringrequired

RippleNet address of the sending account. Always set to null if the transaction_type is set to TRANSFER.

Example: "rn.us.ca.san_francisco"

receiver_addressstringrequired

RippleNet address of the recieving account. Always set to null if the transaction_type is set to TRANSFER.

Example: "rn.mx.mexico"

total_elementsinteger(int64)required

total elements in paginated response

Example: 1

sortstringrequired

retained for backward compatibility

firstbooleanrequired

true if this is the first page.

Example: true

lastbooleanrequired

true if this is the last page.

Example: true

numberintegerrequired

page number

Example: 0

numberOfElementsintegerrequired

Number Of elements in this request

Example: 1

sizeintegerrequired

page size

Example: 10

totalPagesintegerrequired

Total number of pages for the given request

Example: 1

Response

application/json

{
  "account_name": "trans_usd_sf",
  "start_datetime": "2018-08-06T23:13:55.997Z",
  "end_datetime": "2020-08-06T23:13:55.997Z",
  "generated_at": "2019-10-01T21:58:23.621Z",
  "currency": "USD",
  "owner": "rn.us.ca.san_francisco",
  "opening_balance": 0,
  "closing_balance": -909,
  "transactions": {
    "content": [ … ],
    "total_elements": 1,
    "sort": "string",
    "first": true,
    "last": true,
    "number": 0,
    "numberOfElements": 1,
    "size": 10,
    "totalPages": 1
  }
}

Get statement by external account ID

Request

Gets a statement for an account that lists payments and transfers that impacted the account's balance during a specified date-time range.

Security

Bearer

Path

external_account_idstringrequired

The external account ID associated with the account.

Query

start-datestringrequired

The lower bound of the date-time range you want to return statement information for, as an ISO-8601 timestamp in UTC. For example, 2018-08-06T23:13:55.997Z.

end-datestringrequired

The upper bound of the date-time range you want to return statement information for, as an ISO-8601 timestamp in UTC. For example, 2018-08-06T23:15:13.218Z.

pageinteger

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

Default 0

sizeinteger[ 1 .. 100 ]

Number of payment and transfer objects to return per page.

Default 10

curl -i -X GET \
  'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/statement/external_account_id/{external_account_id}?start-date=string&end-date=string&page=0&size=10' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully returns an account statement.

Bodyapplication/json

account_namestringrequired

Name of the account the statement covers.

Example: "trans_usd_sf"

start_datetimestring(date-time)required

Lower bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.

Example: "2018-08-06T23:13:55.997Z"

end_datetimestring(date-time)required

Upper bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.

Example: "2020-08-06T23:13:55.997Z"

generated_atstring(date-time)required

Time at which the statement was generated, as an ISO-8601 timestamp in UTC.

Example: "2019-10-01T21:58:23.621Z"

currencystringrequired

Currency supported by the account.

Example: "USD"

ownerstringrequired

Owner of the account

Example: "rn.us.ca.san_francisco"

opening_balancenumberrequired

Opening balance of the account for the given date range.

Example: 0

closing_balancenumberrequired

Closing balance of the account for the given date range.

Example: -909

transactionsobjectrequired

Provides a content array of statement record objects and a set of pagination information fields.

contentArray of objectsrequired

Provides an array of statement record objects.

transaction_idstring(uuid)required

ID of the payment or transfer that caused an account balance change.

Example: "9eca588f-e89d-4629-82fa-da9c4646310f"

transaction_typestringrequired

Type of transaction that caused an account balance change.

Enum"PAYMENT""TRANSFER""EXCHANGE_TRANSFER"

Example: "PAYMENT"

transaction_statestringrequired

Current state of the payment or transfer.

Example: "COMPLETED"

balance_changenumberrequired

Account balance change caused by the transaction.

Example: -15

balance_resultnumberrequired

Account balance after the transaction.

Example: -909

created_atstring(date-time)required

Time at which the transaction was created, as an ISO-8601 timestamp in UTC.

Example: "2019-10-01T21:28:28.354Z"

end_to_end_idstringrequired

ID that the sender of a transaction can specify. Persisted on all xCurrent instances that participated in the transaction.

Example: "91ecb6bd-4dd8-4b53-a900-72b79f3064e4"

internal_idstringrequired

Internal identifier that the sender can optionally specify. Only visible to the sender. Only the sending xCurrent instance stores this ID.

Example: "8afd8e99-4ad4-4f4e-9bb7-018ad8c3a89c"

venue_idstring

The id from an exchange associated with a transaction involving an exchange account.

Example: "nz7RpAujYgnQtjEM"

transaction_hashstring

Hash representing the unique identifier for the transfer of funds in the XRP ledger.

Example: "DB0AFC09E0A94FC1D11F8CBABA48A184E27094F8DD32FCBC46F316E98011E2A6"

returns_payment_with_idstring(uuid)required

The payment_id of the original payment that this payment returns, if this is a returned payment. Always set to null if the transaction_type is set to TRANSFER.

returned_by_payment_with_idstring(uuid)required

The payment_id of the return payment that returned this payment, if this is a returned payment. Always set to null if the transaction_type is set to TRANSFER.

balance_change_created_atstring(date-time)

Timestamp of when the balance change was created

Example: "2019-10-01T21:28:28.354Z"

sender_addressstringrequired

RippleNet address of the sending account. Always set to null if the transaction_type is set to TRANSFER.

Example: "rn.us.ca.san_francisco"

receiver_addressstringrequired

RippleNet address of the recieving account. Always set to null if the transaction_type is set to TRANSFER.

Example: "rn.mx.mexico"

total_elementsinteger(int64)required

total elements in paginated response

Example: 1

sortstringrequired

retained for backward compatibility

firstbooleanrequired

true if this is the first page.

Example: true

lastbooleanrequired

true if this is the last page.

Example: true

numberintegerrequired

page number

Example: 0

numberOfElementsintegerrequired

Number Of elements in this request

Example: 1

sizeintegerrequired

page size

Example: 10

totalPagesintegerrequired

Total number of pages for the given request

Example: 1

Response

application/json

{
  "account_name": "trans_usd_sf",
  "start_datetime": "2018-08-06T23:13:55.997Z",
  "end_datetime": "2020-08-06T23:13:55.997Z",
  "generated_at": "2019-10-01T21:58:23.621Z",
  "currency": "USD",
  "owner": "rn.us.ca.san_francisco",
  "opening_balance": 0,
  "closing_balance": -909,
  "transactions": {
    "content": [ … ],
    "total_elements": 1,
    "sort": "string",
    "first": true,
    "last": true,
    "number": 0,
    "numberOfElements": 1,
    "size": 10,
    "totalPages": 1
  }
}

Get ledger account statementDeprecated

Request

Get statement for a specified Ledger account.

Note: This operation is deprecated. Use the Reports API to view your statements.

Security

Bearer

Path

account_name_with_addressstringrequired

The RippleNet account name and address that you want to return a statement for. Use the format accountname@ripplenetaddress. For example, san_francisco@rn.us.ca.san_francisco.

Query

start-datestringrequired

The lower bound of the date-time range you want to return statement information for, as an ISO-8601 timestamp in UTC. For example, 2018-08-06T23:13:55.997Z.

end-datestringrequired

The upper bound of the date-time range you want to return statement information for, as an ISO-8601 timestamp in UTC For example, 2018-08-06T23:15:13.218Z.

pageinteger

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

Default 0

sizeinteger[ 1 .. 100 ]

Number of payment and transfer objects to return per page.

Default 10

curl -i -X GET \
  'https://docs.ripple.com/_mock/products/payments-odl/api-docs/ripplenet/reference/openapi/statement/ledger/{account_name_with_address}?start-date=string&end-date=string&page=0&size=10' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

Successfully returned statement for a specified ledger account.

Bodyapplication/json

account_namestringrequired

Name of the account the statement covers.

Example: "trans_usd_sf"

start_datetimestring(date-time)required

Lower bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.

Example: "2018-08-06T23:13:55.997Z"

end_datetimestring(date-time)required

Upper bound of the date-time range the statement covers, as an ISO-8601 timestamp in UTC.

Example: "2020-08-06T23:13:55.997Z"

generated_atstring(date-time)required

Time at which the statement was generated, as an ISO-8601 timestamp in UTC.

Example: "2019-10-01T21:58:23.621Z"

currencystringrequired

Currency supported by the account.

Example: "USD"

ownerstringrequired

Owner of the account

Example: "rn.us.ca.san_francisco"

opening_balancenumberrequired

Opening balance of the account for the given date range.

Example: 0

closing_balancenumberrequired

Closing balance of the account for the given date range.

Example: -909

transactionsobjectrequired

Provides a content array of statement record objects and a set of pagination information fields.

contentArray of objectsrequired

Provides an array of statement record objects.

transaction_idstring(uuid)required

ID of the payment or transfer that caused an account balance change.

Example: "9eca588f-e89d-4629-82fa-da9c4646310f"

transaction_typestringrequired

Type of transaction that caused an account balance change.

Enum"PAYMENT""TRANSFER""EXCHANGE_TRANSFER"

Example: "PAYMENT"

transaction_statestringrequired

Current state of the payment or transfer.

Example: "COMPLETED"

balance_changenumberrequired

Account balance change caused by the transaction.

Example: -15

balance_resultnumberrequired

Account balance after the transaction.

Example: -909

created_atstring(date-time)required

Time at which the transaction was created, as an ISO-8601 timestamp in UTC.

Example: "2019-10-01T21:28:28.354Z"

end_to_end_idstringrequired

ID that the sender of a transaction can specify. Persisted on all xCurrent instances that participated in the transaction.

Example: "91ecb6bd-4dd8-4b53-a900-72b79f3064e4"

internal_idstringrequired

Internal identifier that the sender can optionally specify. Only visible to the sender. Only the sending xCurrent instance stores this ID.

Example: "8afd8e99-4ad4-4f4e-9bb7-018ad8c3a89c"

venue_idstring

The id from an exchange associated with a transaction involving an exchange account.

Example: "nz7RpAujYgnQtjEM"

transaction_hashstring

Hash representing the unique identifier for the transfer of funds in the XRP ledger.

Example: "DB0AFC09E0A94FC1D11F8CBABA48A184E27094F8DD32FCBC46F316E98011E2A6"

returns_payment_with_idstring(uuid)required

The payment_id of the original payment that this payment returns, if this is a returned payment. Always set to null if the transaction_type is set to TRANSFER.

returned_by_payment_with_idstring(uuid)required

The payment_id of the return payment that returned this payment, if this is a returned payment. Always set to null if the transaction_type is set to TRANSFER.

balance_change_created_atstring(date-time)

Timestamp of when the balance change was created

Example: "2019-10-01T21:28:28.354Z"

sender_addressstringrequired

RippleNet address of the sending account. Always set to null if the transaction_type is set to TRANSFER.

Example: "rn.us.ca.san_francisco"

receiver_addressstringrequired

RippleNet address of the recieving account. Always set to null if the transaction_type is set to TRANSFER.

Example: "rn.mx.mexico"

total_elementsinteger(int64)required

total elements in paginated response

Example: 1

sortstringrequired

retained for backward compatibility

firstbooleanrequired

true if this is the first page.

Example: true

lastbooleanrequired

true if this is the last page.

Example: true

numberintegerrequired

page number

Example: 0

numberOfElementsintegerrequired

Number Of elements in this request

Example: 1

sizeintegerrequired

page size

Example: 10

totalPagesintegerrequired

Total number of pages for the given request

Example: 1

Response

application/json

{
  "account_name": "trans_usd_sf",
  "start_datetime": "2018-08-06T23:13:55.997Z",
  "end_datetime": "2020-08-06T23:13:55.997Z",
  "generated_at": "2019-10-01T21:58:23.621Z",
  "currency": "USD",
  "owner": "rn.us.ca.san_francisco",
  "opening_balance": 0,
  "closing_balance": -909,
  "transactions": {
    "content": [ … ],
    "total_elements": 1,
    "sort": "string",
    "first": true,
    "last": true,
    "number": 0,
    "numberOfElements": 1,
    "size": 10,
    "totalPages": 1
  }
}

Beneficiary confirmation

Use these operations to perform beneficiary confirmations.

Operation	Method	Description
Get account lookup by status	GET	Get Account Lookup entities by status and other filters.
Initiate account lookup	POST	Creates an Account Lookup request to validate a beneficiary's account details before sending a payment.
Complete account lookup	POST	Posts an Account Lookup response to validate a beneficiary's account details before payment.
Get account lookup by ID	GET	Gets an Account Lookup entity for its `account_lookup_id` value.

Operations

Diagnostics

Use these operations to view RippleNet Server health.

Operation	Method	Description
Check health	GET	Gets the health status of the xCurrent server.
Check heartbeat	GET	Gets the health status of the xCurrent server's peers.

Operations

Exchange transfers

Use these operations to manage exchange transfers.

Operation	Method	Description
Get exchange transfers	GET	List all exchange transfers.
Execute exchange transfer	POST	Execute an exchange transfer to move funds from one of your accounts in one currency, to another one of your accounts in another currency.
Get exchange transfer quote	POST	Requests a quote for an exchange transfer.
Complete exchange transfer	POST	Updates the status of an exchange transfer to `COMPLETED`. Make this request once the exchange transfer has been made on both the ledger and on internal systems.
Get exchange transfer by ID	GET	Gets an exchange transfer by ID.

Operations

Fees

Use these operations to configure fees.

Operation	Method	Description
Get fees	GET	List all fees.
Create fee	POST	Creates a fee.
Get fee by ID	GET	Gets a fee by ID.
Update fee	PUT	Updates an existing fee.
Delete fee	DELETE	Deletes a fee. Once deleted, a fee cannot be accessed.

Operations

Non-orchestration payments

Operations

Orchestration payments

Operations

Payment expiration

Use these operations to manage payment expirations.

Operation	Method	Description
Get payment expiry by ID	GET	Gets the time to live (ttl) of a payment expiry in seconds.
Update payment expiry	PUT	Updates the time to live (ttl) of a payment expiry in seconds.
Delete payment expiry	DELETE	Deletes a payment expiry.
Get payment expiries	GET	Returns all configured payment expiries.
Create payment expiry	POST	Creates a payment expiration window, or time to live (ttl), in seconds.

Operations

Payout method

Payout Method operations let receivers create and manage payout methods. Senders can generate quotes based on these receiver payout methods.

Operation	Method	Description
Create payout method	POST	Creates a payout method. For example, `LOCAL_RAILS`.
Get payout methods	GET	Returns a list of payout methods created by a receiving partner.
Get payout method by ID	GET	Returns a payout method by its ID.
Update payout method	PUT	Updates a payout method.
Delete payout method	DELETE	Deletes a payout method.
Get all categories	GET	Returns all the payout method categories.

Operations

Platform accounts

Use these operations to configure your RippleNet platform accounts.

Operation	Method	Description
Create platform	POST	Creates a RippleNet platform that represents a financial entity that holds accounts in the real world. For example, a Bank, Exchange, or Wallet provider.
Get all platforms	GET	Returns a list of all active RippleNet platforms.
Get platform by platform ID	GET	Get a RippleNet platform by its platform ID.
Update platform	PUT	Updates a RippleNet platform.
Delete platform by platform ID	DELETE	Deletes a RippleNet platform by its platform ID.
Create platform account	POST	Creates a RippleNet platform account, which represents a real-world account owned by a financial entity.
Get platform accounts	GET	Returns a paged list of all active RippleNet platform accounts.
Get platform account by platform account ID	GET	Gets a RippleNet platform account by its platform account ID.
Update platform account	PUT	Updates a RippleNet platform account.
Delete platform account by platform account ID	DELETE	Deletes a RippleNet platform account by its platform account ID.
Get platform accounts balances	GET	Get balances for local Platform Accounts
Get platform account statement	GET	Get statement for a specified Platform Account

Operations

Pool accounts

Use these operations to configure your RippleNet pool accounts.

Operation	Method	Description
Get all pool accounts	GET	Returns a list of all pool accounts on a RippleNet node.
Get pool account by pool account ID	GET	Get a pool account by its pool account ID.

Operations

Quote expiration

Use these operations to manage quote expirations.

Operation	Method	Description
List quote expiries	GET	Returns all configured quote expiries.
Create quote expiry	POST	Creates a quote expiration window, or time to live (ttl), in seconds.
Get quote expiry	GET	Gets the configured quote expiration window, or time to live (ttl), in seconds.
Update quote expiry	PUT	Sets a quote expiration window, or time to live (ttl), in seconds.

Operations

Quotes

Use these operations to manage your quotes.

Operation	Method	Description
Accept quote	POST	Accepts a quote ID to start the payment process.
Get quotes	GET	Gets a list of quotes.
Get quote by quote ID	GET	Gets a quote by ID.
Create quote collection	POST	Creates a collection of quotes for a proposed payment.
Get quote collection by ID	GET	Gets a quote collection that was created for a proposed payment.

Operations

Rates

Use these operations to manage your rates.

Operation	Method	Description
Get rates	GET	Gets a list of configured exchange rates.
Create rate	POST	Creates an exchange rate for a specified currency pair.
Get rate by ID	GET	Gets a configured exchange rate by ID.
Update rate	PUT	Updates an existing exchange rate.
Delete rate	DELETE	Deletes an exchange rate. Once deleted, an exchange rate cannot be accessed.

Operations

Request for payment

Use these operations to interact with your payment requests.

Operation	Method	Description
Get requests for payment	GET	Gets requests for payment that match the query parameters.
Send request for payment	POST	Sends a new request for payment.
Get request for payment by ID	GET	Gets a request for payment by request for payment ID.
Accept request for payment	POST	Accepts a request for payment.
Fail request for payment	POST	Fails a request for payment.

Operations

Transfers

Use these operations to manage your transfers.

Operation	Method	Description
Get transfers	GET	Gets a list of transfers.
Get transfer estimate	GET	Get 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 ID	GET	Gets a transfer by ID.
Execute transfer	POST	Transfers funds between accounts.
Complete transfer	POST	Updates the state of a transfer to `COMPLETED`.
Add transfer labels	PUT	Adds a list of labels to the transfer. To retrieve transfers by label, see Get transfers
Delete transfer labels	DELETE	Deletes one or more existing labels from the transfer.

Operations

RippleNet Server API (4.0.0)

Authentication

API environments

Auditing

Balances and statements

Get balances

Request

Responses

Was this page helpful?

Get ledger balances

Request

Responses

Was this page helpful?

Get statement

Request

Responses

Was this page helpful?

Get statement by external account ID

Request

Responses

Was this page helpful?

Get ledger account statementDeprecated

Request

Responses

Was this page helpful?

Beneficiary confirmation

Diagnostics

Exchange transfers

Fees

Non-orchestration payments

Orchestration payments

Payment expiration

Payout method

Platform accounts

Pool accounts

Quote expiration

Quotes

Rates

Request for payment

Transfers