RIripple
Fiat instructions

Get bank details

Changed on

Returns the Ripple bank account to wire fiat to when buying stablecoin - the same object embedded as bankDetails on every fiat instruction, served on its own.

The bank belongs to your account rather than to any one instruction, so this is the endpoint to call when you want the wire destination without creating or listing an instruction: rendering a "where to send funds" panel, caching the details, or checking them on a schedule.

This endpoint does not return a memo. A memo is per-payment and comes only from a fiat instruction; the bank details alone are not enough to have a payment attributed. Create an instruction for every payment you intend to send.

Unlike the embedded bankDetails field, which is simply absent on any failure so that the instruction and its memo still come back, this endpoint keeps its failures apart: a 404 is a settled answer and retrying will not change it, a 502 is transient.

get/v1/stablecoin/fiat-bank-details

Request

Response

The Ripple bank account to wire fiat to

bankNamestring required

Name of the bank holding the account. May be an empty string.

accountNamestring required

Name the account is held under - the Ripple legal entity you are paying. May be an empty string.

accountNumberstring

Account number to wire to.

ibanstring

IBAN to wire to, for accounts identified that way.

swiftBicCodestring
routingNumberstring
referencestring

Reference Ripple wants quoted on transfers to this account. Distinct from the instruction's memo, which is what actually attributes the payment - send both.

Example response

{
  "bankName": "ABC Bank",
  "accountName": "RIPPLE LABS CAYMAN LTD.",
  "accountNumber": "000000",
  "swiftBicCode": "ABCBUS33XXX",
  "routingNumber": "0000",
  "bankAddress": {
    "street": "1 Example Street",
    "city": "Singapore",
    "state": "Singapore",
    "zipCode": "000000",
    "country": "Singapore"
  }
}

Changes