--- title: "Get quote by quote ID" method: GET path: "/quotes/{quote_id}" tags: ["Quotes"] --- # Get quote by quote ID `GET /quotes/{quote_id}` Gets a quote by ID. ## Path parameters - `quote_id` string, uuid, required ## Response `200` Successfully retrieved quote. - Quote — JSON response object that represents a quote for a proposed payment or return payment. - `quote_id` string, uuid, required — Unique identifier for the quote. - `created_at` string, date-time, required — Date and time at which the quote was created, as an ISO-8601 timestamp in UTC. - `expires_at` string, date-time, required — Date and time after which the quote and its pricing expire, as an ISO-8601 timestamp in UTC. - `type` 'SENDER_AMOUNT' | 'RECEIVER_AMOUNT' | 'SENDER_INSTITUTION_AMOUNT' | 'RECEIVER_INSTITUTION_AMOUNT' | 'REVERSAL_AMOUNT', required — Indicates how the amount field should be treated for calculating quote values. - `price_guarantee` string, required — Indicates whether a quote's pricing is `INDICATIVE` or `FIRM`. An `INDICATIVE` quote allows for price movements between quote issuance and payment execution, such that the quoted amount and delivered amount may differ. A `FIRM` quote ensures that the quoted and delivered payment amounts are equal. - `sender_address` string, required — RippleNet account name and address of the sender, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`. - `receiver_address` string, required — RippleNet account name and address of the receiver, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`. - `amount` string, required — Amount to be sent or received, depending on the `type` value. - `currency_code` string, required — Currency code for the `amount` value. - `currency_code_filter` string, required — Currency code that can be used to filter quotes at the opposite end of the quote request. For example, you can filter by this currency code to find the receiving currency for a quote with a `SENDER_AMOUNT` quote_type. If not sent in the request, this field value is set to `null`. - `service_type` string, required — Returns `null`. - `quote_elements` QuoteElement[], required — Transfer and exchange elements. A transfer element represents a movement of funds between two accounts. An exchange element represents the exchange of currencies between two accounts. - `quote_element_id` string, uuid, required — Unique identifier for the quote element. - `quote_element_type` 'TRANSFER' | 'EXCHANGE' | 'EXCHANGE_TRADE' | 'CRYPTO_TRANSFER', required — Type of quote element.

- `quote_element_order` string, required — Order of each quote element along the liquidity path. If a quote includes five quote elements, each one is enacted according to its quote_element_order number to make the proposed payment. - `sender_address` string, required — RippleNet account name and address of the sender, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`. - `receiver_address` string, required — RippleNet account name and address of the receiver, in the format `accountname@ripplenetaddress`. For example, `new_york@rn.us.ny.new_york`. - `sending_amount` number, required — Amount the sender is sending. - `receiving_amount` number, required — Amount the receiver is receiving. - `sending_fee` number, required — Fees the sender is charging. When `quote_element_type` is set to `EXCHANGE`, this field value is always set to `0`. - `receiving_fee` number, required — Fees the receiver is charging. When `quote_element_type` is set to `EXCHANGE`, this field value is always set to `0`. - `sending_currency_code` string — Currency code of the sending amount. Included in quote elements with `quote_element_type` set to `EXCHANGE`. - `receiving_currency_code` string — Currency code of the receiving amount. Included in quote elements with `quote_element_type` set to `EXCHANGE`. - `fx_rate` FXRate — The details of an FX Rate for a quote or payment. - `rate` number, required — Exchange rate between a base and counter currency. - `base_currency_code` string, required — Currency code of the base currency. - `counter_currency_code` string, required — Currency code of the counter currency. - `type` string, required — Order type of the exchange rate. Valid values are `buy` or `sell`. - `transfer_currency_code` string — Currency code of the transfer. Included in quote elements with `quote_element_type` set to `TRANSFER`. - `liquidity_warning` string, required — Triggered when a quote causes an account to go below its `minimum_allowed_balance`. Otherwise, this field value is set to `null`. - `payment_method` string — Payout method for the quote. - `payment_method_fields` string — JSON object containing payment method metadata. - `payout_method_info` object — Details about the payout method. - `payout_method_name` string — Payout method for the quote. - `payout_method_category` 'REAL_TIME_GROSS_SETTLEMENT_SYSTEM' | 'REAL_TIME_NET_SETTLEMENT_SYSTEM' | 'MASS_NET_PAYMENT_SYSTEM' | 'BOOK_TRANSFER' | 'CASH_PAYOUT' | 'WALLET_PAYMENT' | 'OTHER' — Category of the payout method. Defaults to OTHER if not specified. - `description` string — User defined description of the payout method. - `estimated_time_to_credit` string — The estimated time to credit the beneficiary using this payout method. ## Other responses - `400` — Bad request. Quote ID is either invalid or not found. --- [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)