# ICHRA Quote Status

The Show an ICHRA Quote endpoint ([API docs](https://docs.ideonapi.com/#group-ichra-quoting-group-ichra-quoting-get)) can be used to poll for status of an ICHRA quote. This endpoint shows all quote information - both the request parameters and metadata. The same schema is included in successful responses to the Create an ICHRA Quote endpoint.

## Polling ICHRA Quote Status

The `job.status` field should be used for polling to assess quote readiness. A *complete* or *complete\_with\_error* status indicates that the quote processing has completed and results are available as documented in the [Pull Quote Results section](/quote-and-select/quote-groups/ichra-group-quoting/pull-quote-results.md). A *failed* status indicates that the processing is complete, but the group was not able to be quoted. The *failed* status is expected to be very rare; failed quotes can be re-tried automatically. Multiple successive failures should be escalated to Ideon's support portal.

The cadence at which any given quote is polled for its status should be dynamic based on the group size and expected processing times, as documented in the [ICHRA Group Quoting section FAQ](/quote-and-select/quote-groups/ichra-group-quoting.md#faq).

## ICHRA Quote Metadata

The metadata for an ICHRA quote includes the unique `id` for the quote, information on the asynchronous processing, and bulk export file availability, if requested as an optional output. These additional fields are shown in the example request below.

{% code title="GET /ichra\_quotes/\<ichra\_quote\_id>" %}

```json
{
    "quote": {
        // ICHRA quote request parameters,
        "id": "abcd1234",
        "created_at": "2026-01-01T00:00:00.000Z",
        "job": {
            "status": "complete",
            "status_updated_at": "2026-01-01T00:01:00.000Z",
            "total_members": 10,
            "total_dependents": 10,
            "error_count": 0
        },
        "bulk_export": {
            "export_id": "24c47bf1-d06e-4711-862a-bdf9ae0acd81",
            "status": "complete",
            "download_url": "https://example.com"
        }

    }
}
```

{% endcode %}

#### ICHRA Quote Job Data

The `job` object contains processing status information for the ICHRA quote in addition to quote metadata. The following parameters are included.

* **Status** `status` - the status of the ICHRA quote job that can be referenced when polling for completion. Valid statuses include the following:
  * *pending* - initial status indicating that no members quoted yet and processing is not started beyond initial quote creation.&#x20;
  * *in\_progress* - job processing is underway, some but not all members are quoted.
  * *generating\_export -* the quote job is complete and the bulk export file is being generated. Only used if the bulk export is enabled in the quote request.
  * *complete* - job processing is complete and all members were successfully quoted.
  * *complete\_with\_errors* - job processing is complete and one or more members were not able to be quoted.
  * *failed* - a more significant failure occurred and no members were quoted.
* **Status Last Updated At** `status_updated_at` - the timestamp of when the `status` last transitioned statuses.
* **Total Members and Dependents** `total_members` and `total_dependents` - the sum of members and their dependents in the group when the ICHRA quote was created.
* **Member Error Count** `error_count` - the number of members that were not able to be quoted. If the `status` is returned as *complete\_with\_errors,* then this count will be greater than 0.&#x20;

#### Bulk Export Job Data

Bulk files are an optional quote output, documented in the [Quote a Group for ICHRA](/quote-and-select/quote-groups/ichra-group-quoting/quote-a-group-for-ichra.md) and [Pull Quote Results sections](/quote-and-select/quote-groups/ichra-group-quoting/pull-quote-results.md). The metadata included in the `bulk_export` object includes an identifier, status, and download URL for the file. When the `status` is returned as *complete*, a pre-signed URL to download the file will be available in the `download_url` field. This process is consistent with the [Bulk Exports in the API workflow](/quote-and-select/additional-information-and-workflows/bulk-exports-in-the-api.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ideonapi.gitbook.io/quote-and-select/quote-groups/ichra-group-quoting/ichra-quote-status.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.