getQuote

suspend fun getQuote(id: String, jwtToken: String): Sep38QuoteResponse

Retrieves a previously created firm quote by ID.

Fetches the current state and details of a firm quote that was created via postQuote. Quotes must remain available past their expiration time to allow clients to verify quote details after execution.

This endpoint is useful for:

  • Checking quote expiration before initiating a transfer

  • Verifying quote details during transaction flow

  • Retrieving quote information for transaction reconciliation

Authentication is required. The JWT token must be from the same user who created the quote.

Return

Sep38QuoteResponse containing quote details

Parameters

id

Unique identifier of the quote to retrieve

jwtToken

Required JWT token from SEP-10 authentication

Throws

If request parameters are invalid (400)

If authentication is missing or invalid (403)

If quote ID is not found (404)

For unexpected HTTP status codes

Example:

val quoteId = "de762cda-a193-4961-861e-57b31fed6eb3"
val quote = quoteService.getQuote(quoteId, jwtToken)

// Check if quote is still valid
val expiresAt = Instant.parse(quote.expiresAt)
val isExpired = Instant.now() > expiresAt

if (isExpired) {
println("Quote expired at ${quote.expiresAt}")
// Request new quote
} else {
println("Quote valid for ${Duration.between(Instant.now(), expiresAt).toMinutes()} more minutes")
// Proceed with transaction
}