Quotes

Quotes are available on a ready questionnaire as q.quotes.

if (q.ready) {
  const quoteSet = await q.quotes.wait();
}

Reference

q.quotes.wait(options?)

Polls until the quote set settles, honouring the server’s Retry-After.

• options.timeoutMs (optional): default 120000. Rejects with TimeoutError after this.
• options.signal (optional): an AbortSignal.

Returns Promise<QuoteSet>.

Caveats: if quoting fails, rejects with QuoteFailedError. Call its retry().

---

q.quotes.get()

Polls once. Returns { state: "quoting", retryAfterMs } or { state: "quoted", quoteSet }.

---

QuoteSet

• quotes: Quote[].
• quoteComparisonUrl: the signed URL to send the customer to. Pass it through untouched.
• raw: the response body.

Quote

The wire fields (id, insurer, decision, premium, policy_expiry, …) plus:

quote.detail()

Returns Promise<QuoteDetail>: covers, insurer responses and reference.

quote.select()

Chooses this quote; it’s carried to purchase. Returns Promise<void>.

Caveats: referred and declined quotes can’t be selected: this throws AffordanceUnavailableError.

Usage

Select the first selectable quote

const quoteSet = await q.quotes.wait();
const quote = quoteSet.quotes.find((x) => x.decision === 'quoted');
if (quote) await quote.select();
location.assign(quoteSet.quoteComparisonUrl);

Show quotes in a UI

Use toQuoteCards for formatted premiums and a selectable flag.