# Enrollment Decision Path

Two boolean fields on each plan in the QuoteConnect API response indicate which enrollment paths are available:

<table><thead><tr><th width="206.5">Field</th><th width="132">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>deeplink_enrollment</code></td><td><code>boolean</code></td><td>Plan supports enrollment via the Application Deeplink.</td></tr><tr><td><code>api_enrollment</code></td><td><code>boolean</code></td><td>Plan supports full enrollment via the EnrollConnect API.</td></tr></tbody></table>

***

#### Example Response

```json
{
  "plans": [
    {
      "hios_id": "53901AZ1490005",
      "name": "Blue Portfolio HSA Gold Statewide PPO",
      "gross_premium": 450.25,
      "year": 2026,
      "deeplink_enrollment": true,
      "api_enrollment": true
    },
    {
      "hios_id": "84271TX0100001",
      "name": "Ambetter Balanced Care 15",
      "gross_premium": 325.00,
      "year": 2026,
      "deeplink_enrollment": true,
      "api_enrollment": false
    }
  ]
}
```

***

#### Routing Logic

```
┌────────────────┐
│  POST /quotes  │
└───────┬────────┘
        │
        v
┌───────────────────────────┐
│ api_enrollment = true?    │──yes──> EnrollConnect API
└───────────┬───────────────┘
            │ no
            v
┌───────────────────────────┐
│ deeplink_enrollment = true│──yes──> Application Deeplink
└───────────┬───────────────┘
            │ no
            v
    Not enrollable via
       HealthSherpa
```

{% hint style="info" %}
Both the EnrollConnect API and the Application Deeplink accept the same canonical request schema. Build your payload once, then route it to either endpoint based on these flags.
{% endhint %}

***

#### Plan Lookup

Retrieve enrollment flags and plan details for a specific plan without running a full quote:

```
GET /api/v1/plans/:hios_id?plan_year=2026
```

Returns plan data along with `deeplink_enrollment` and `api_enrollment` flags:

```json
{
  "hios_id": "53901AZ1490005",
  "name": "Blue Portfolio HSA Gold Statewide PPO",
  "year": 2026,
  "deeplink_enrollment": true,
  "api_enrollment": true
}
```

This is useful when you already have a plan selected and need to confirm which enrollment path it supports before building your request.

***

#### Attestation Content

Pass `include=enrollment_requirements` on the plan lookup request to retrieve carrier- and state-specific attestation text:

```
GET /api/v1/plans/:hios_id?plan_year=2026&include=enrollment_requirements
```

The response includes an `enrollment_requirements.attestations` object with the text your platform must present to applicants during enrollment. Display the `content` value in your UI, then pass the corresponding boolean or signature fields in the application request.

**Example (abbreviated)**

```json
{
  "plan": {
    "hios_id": "53901AZ1490005",
    "deeplink_enrollment": true,
    "api_enrollment": true,
    "enrollment_requirements": {
      "attestations": {
        "agrees_issuer_attestations": {
          "content": "By signing below, I certify that the information..."
        },
        "electronic_signature_consent": {
          "content": "%{signature_name}, type your full name to sign electronically."
        },
        "broker_signature_attestation": {
          "content": "I attest that I have reviewed the application..."
        },
        "pediatric_dental": {
          "content": "I understand that pediatric dental coverage...",
          "options": ["purchased_separately", "not_applicable"]
        }
      }
    }
  }
}
```

Keys that are `null` or absent indicate the attestation is not required for this carrier/state combination.

{% hint style="warning" %}
**Placeholder values**: The `electronic_signature_consent` content may contain `%{signature_name}`. Replace this with the applicant's full legal name before displaying the text in your UI. All other placeholders (carrier name, etc.) are resolved server-side.
{% endhint %}

See the Plan Lookup section of the [QuoteConnect API](https://docs.ichra.healthsherpa.com/api-reference/endpoints/quoteconnect-api) for the complete attestation schema and field-to-request mapping.

***

#### Backward Compatibility

* Enrollment flags (`deeplink_enrollment`, `api_enrollment`) are always included in the plan lookup response.
* The `include=enrollment_information` parameter is additive. Existing integrations that do not pass it are unaffected.
* On the QuoteConnect response, the `include_non_enrollable_offex` parameter is unchanged.
* Enrollment flags can be requested via `filter` on the quotes endpoint:

```
GET /api/v1/quotes?...&filter=deeplink_enrollment,api_enrollment
```


---

# 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/enrollment-decision-path.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.