> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.truvo.com/api-reference/mcp/get-quote-request/llms.txt.

# 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}`](/api-reference/get-quote-request)

| Field           | Type             | Required | Description                                                                                           |
| --------------- | ---------------- | -------- | ----------------------------------------------------------------------------------------------------- |
| `id`            | string           | Yes      | The quote request ID, which starts with `qreq_`.                                                      |
| `wait_seconds`  | integer, 0 to 20 | No       | The longest the read waits for a change, in seconds. 20 when you leave it out.                        |
| `since_version` | integer          | No       | The `version` from your last answer, so a newer version answers at once.                              |
| `read_handle`   | string           | Yes      | Platform key and keyless only. The `read_handle` that `start_quote_request` returned for the request. |