Skip to main content
GET
Get quote
This is a record, not a reservation. Reading a quote neither extends nor consumes it. An expired quote is returned normally, with expired: true — expiry is enforced when you use the quote, on Create pre-transaction, not when you read it.

What comes back

fxRate is not the rate you are charged at. It is the raw partner rate before markup; the markup is charged as a fee line instead. Multiplying sourceAmount by fxRate will not reproduce destinationAmount. Reconcile with the amounts and charges.
This is a deliberately narrower view than the one Generate quote returns — it is the stored record, not the pricing response.

Errors

A quote belonging to another customer and a quote that does not exist return the same 404, deliberately — so quote ids cannot be probed for existence.

Working request

Working response

200, and the body is the quote record itself — no envelope on a success.
This is a narrower view than Generate quote returns. It is the stored record, so the names differ — charges here is feeList there, and chargesTotal is feeTotal. There is no gasFeeBreakdown, no coupon and no partnerId, and sourceAmount carries the stored four-place scale rather than the two places the pricing response normalises to. Nulls are present rather than omitted.
An expired quote returns exactly this, with expired: true. The record is not deleted and the endpoint does not start refusing it.

Authorizations

API-KEY
string
header
required

Your partner API key.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. Required on every /api/v0/* call. Format YYYY-MM.<release>; 2026-09.1 is the latest. The version that served the request is echoed back on the response. Missing, malformed or unsupported values are rejected with 400.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

userId
string
required

The customer the quote belongs to. Must be a cus_… reference id, and must belong to your partner account. Malformed, unknown, soft-deleted or another partner's → 404 ERRREF_1001.

Example:

"cus_9HqA2mT7xK4vRb1NdLpZ"

quoteId
string
required

The quote to read. Must be a qut_… reference id. Malformed → 400 ERRREF_1000; well-formed but unknown, or belonging to another customer → 404 ERRQUO_1000.

Example:

"qut_4RmP8kY2wN6tJc3VfBxQ"

Response

The stored quote record. Unwrapped — the body is the record itself, with no envelope.

quoteId
string

The qut_… reference id.

userId
string

The customer the quote belongs to.

sourceCurrency
string

The currency as requested.

sourceAmount
number

The source amount as requested — on a reverse quote, the amount that was derived. Carries the stored four-place scale.

sourceChain
string | null

Network for a stablecoin source. null on a fiat leg.

destinationCurrency
string

The destination currency.

destinationAmount
number

What the recipient receives, after fees.

destinationChain
string | null

Network for a stablecoin destination. null on a fiat leg.

fxRate
number

The partner rate before markup. Multiplying sourceAmount by fxRate will not reproduce destinationAmount.

chargesTotal
number

Sum of all fee lines. feeTotal on Generate quote.

chargesTotalCurrency
string

Always the source currency.

charges
object[]

Every fee line. feeList on Generate quote.

expiresOn
string<date-time>

ISO-8601 instant, ten minutes after generation.

expired
boolean

Computed at read time against expiresOn. An expired quote is still returned, with true.

test
boolean

Whether the quote was priced in test mode.

createdOn
string<date-time>

ISO-8601 instant.