get_quote_request

Reads a quote request: its status, the terms and next actions of each quote, and the result from each carrier. It starts no new quote. While the request is in_progress, the answer waits for the request to change: a new quote or a new status. wait_seconds, from 0 to 20, is the longest it waits, and 20 when you leave it out. Send since_version with the version from your last answer, so a change since then answers at once. The status is in_progress, action_required, completed, or failed: branch on it. status_details.message says why, in words you can show the person. New status_details.reason values can arrive, so don’t rely on the reason alone. A failed request says what to do next. A completed request can hold no quotes, and a carrier can decline or give no answer. Report each result as it is. Each quote’s price.premium is in US cents (amount_minor) and is the price for the whole term in term_months. The billing cycle does not change that: a quote billed monthly still gives the premium for the whole term. On a renters quote, the premium already includes every fee in price.fees. On other lines, the quote doesn’t say whether it does.

• Title: Get a quote request
• Callers: partner key, platform key, and keyless
• Hints: readOnlyHint: true, destructiveHint: false
• Result: quote_request, the quote request as HTTP returns it, and quotes, each of its quotes in full.
• HTTP: GET /v1/quote-requests/{id}

Try it