# Use Cases

This section outlines how to use our modular endpoints: QuoteConnect, Enrollment Deeplink, and EnrollConnect. These endpoints power flexible ICHRA workflows.

Our endpoints are designed to be composable. You can implement them individually or in combination based on your platform's needs.

#### Use Case Overview

<table><thead><tr><th width="174.5">Workflow</th><th>Endpoints Used</th><th>Description</th></tr></thead><tbody><tr><td>Quote Only</td><td>QuoteConnect <code>POST /quotes</code></td><td>Power plan comparison experiences, affordability tooling, and ICHRA Class Optimization.</td></tr><tr><td>APTC Only</td><td>QuoteConnect <code>POST /aptc_estimates</code></td><td>Estimate on-exchange subsidy eligibility for affordability tooling and ICHRA Class Optimization.</td></tr><tr><td>Deeplink</td><td><code>POST /ichra/off_ex</code></td><td>Use Deeplink-based flows for minimal-input enrollments.</td></tr><tr><td>EnrollConnect</td><td><code>POST /api/v1/applications</code> + lifecycle</td><td>Full programmatic enrollment without HealthSherpa UI.</td></tr><tr><td>Webhooks</td><td>Submission Confirmation + Policy Status</td><td>Receive update notifications on application submission and policy updates.</td></tr><tr><td>Full Experience</td><td>All Endpoints</td><td>Power affordability tools, class optimization tools, member shopping, and enrollment.</td></tr></tbody></table>

### Example Workflow

#### Shop & Enroll

1. **Define Employer Strategy**

   Gather the Employer's and/or Agent’s objectives—e.g., affordability targets, allowance ranges, geographic constraints, or broker-servicing preferences.
2. **Generate Plan Pricing**

   Use the `POST /quotes` endpoint to retrieve the **lowest-cost silver plan (LCSP)** for each eligible employee, based on their age and home zip code.
3. **Model Affordability Scenarios**

   Use affordability insights to propose an ICHRA class strategy that meets both:

   * IRS affordability requirements
   * The employer’s budget and policy goals
4. **Generate Quotes**\
   Call `POST /quotes` to retrieve ACA plans for the employee's household.
5. **Capture Selection**\
   Allow employees to browse and select their preferred plan.
6. **Choose Enrollment Path**\
   Check the `api_enrollment` and `deeplink_enrollment` flags on the selected plan:
   * If `api_enrollment` is true — proceed with EnrollConnect (step 4a).
   * Otherwise, if `deeplink_enrollment` is true — proceed with Deeplink (step 4b).
   * See [Enrollment Decision Path](/integration-guide/enrollment-decision-path.md) for routing logic and carrier support details.
7. **Enroll**
   * **4a. EnrollConnect**\
     Call `POST /api/v1/applications` with the selected plan and applicant data. Update via `PUT /api/v1/applications/:id` until `errors` is empty, then call `POST /api/v1/applications/:id/submit`.
   * **4b. Deeplink**\
     Call `POST /ichra/off_ex` to generate a redirect URL. The agent or employee completes enrollment in HealthSherpa's UI.
8. **Track Status**\
   Poll `GET /api/v1/applications/:id` or receive webhook notifications for submission confirmation and policy status changes.


---

# 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://docs.ichra.healthsherpa.com/integration-guide/use-cases.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.