---
title: "Create a group quote intent"
method: POST
path: "/group_quote_intents"
tags: ["Group Quote Intents"]
---

# Create a group quote intent

`POST /group_quote_intents`

Creates a `group_quote_intent` to request a quote for a `group` and `plan` combination. The intent coordinates the quote workflow including requirements collection and quote generation.

## Headers

- `X-Platform-Id` string

## Request body

- CreateGroupQuoteIntentRequest
  - `group_id` string, required — Unique identifier for the group to get a quote for
  - `plan_id` string, required — Unique identifier for the plan to get a quote for
  - `cost_sharing` HealthInsuranceCostSharingConfigurationResponse
    - `type` 'member_count' | 'member_selection' | 'percentage' | 'policyholder_only' | 'family_type', required
    - `member_count` HealthInsuranceMemberCountCostSharingConfigurationResponse
      - `adults` integer, required — Number of additional adults covered, including partner/spouse.
      - `children` integer, required — Number of additional children covered.
    - `member_selection` HealthInsuranceMemberSelectionCostSharingConfigurationResponse
      - `partner` boolean, required — If a spouse/partner is covered.
      - `children` boolean, required — If children are covered.
    - `percentage` HealthInsurancePercentageCostSharingConfigurationResponse
      - `percentage` integer, required — Employer coverage percentage: For 40% send 40. For 100% send 100.
    - `family_type` HealthInsuranceFamilyTypeCostSharingConfigurationResponse
      - `type` 'single' | 'couple' | 'single_with_children' | 'family', required
  - `expected_start_date` string, date, nullable — Expected start date for the insurance coverage
  - `coverage_selections` PlanCoverageOptionSelectionRequest[], nullable — Plan coverage option selections for group-policy-scoped configurations.
    - `configuration_id` string, required — Configuration ID (prefixed with `pc_`).
    - `options` SelectedOptionRequest[], required — Selected options with optional sub-options.
      - `option_id` string, required — Option ID (prefixed with `pco_`).
      - `sub_options` SelectedOptionRequest[], nullable — Sub-option selections, if applicable.

## Response `200`

OK

- GroupQuoteIntentResponse
  - `id` string, required — Unique identifier for the group quote intent
  - `group_id` string, required — Unique identifier for the group
  - `plan_id` string, required — Unique identifier for the plan
  - `status` 'processing' | 'action_required' | 'awaiting_quote' | 'quote_available' | 'rejected' | 'rejected_by_insurer' | 'quote_expired', required
  - `cost_sharing` HealthInsuranceCostSharingConfigurationResponse
    - `type` 'member_count' | 'member_selection' | 'percentage' | 'policyholder_only' | 'family_type', required
    - `member_count` HealthInsuranceMemberCountCostSharingConfigurationResponse
      - `adults` integer, required — Number of additional adults covered, including partner/spouse.
      - `children` integer, required — Number of additional children covered.
    - `member_selection` HealthInsuranceMemberSelectionCostSharingConfigurationResponse
      - `partner` boolean, required — If a spouse/partner is covered.
      - `children` boolean, required — If children are covered.
    - `percentage` HealthInsurancePercentageCostSharingConfigurationResponse
      - `percentage` integer, required — Employer coverage percentage: For 40% send 40. For 100% send 100.
    - `family_type` HealthInsuranceFamilyTypeCostSharingConfigurationResponse
      - `type` 'single' | 'couple' | 'single_with_children' | 'family', required
  - `expected_start_date` string, date, nullable — Expected start date for the insurance coverage
  - `action_required` GroupQuoteIntentActionRequiredResponse
    - `code` 'provide_dependant_information' | 'provide_beneficiary_information' | 'provide_missing_information', required
    - `reason` string, required — Brief reason for the required action.
    - `reason_description` string, required — Detailed description of the required action.
    - `due_by` string, date-time, required — The deadline by which the action must be completed. The day is included (i.e. the action can be completed any time during this day in the user's local time).
  - `consent_links` ConsentLinkResponse[], required — Consent links that need to be acknowledged
    - `type` 'terms_of_business' | 'privacy_policy', required
    - `url` string, required — URL to the consent document
    - `version` string, required — Version of the consent document
  - `disclosures` DisclosureResponse[], required — Disclosures associated with this intent.
    - `category` 'regulatory' | 'provider' | 'intermediary', required
    - `type` 'intermediary_role' | 'intermediary_commission' | 'underwriter_disclaimer' | 'anti_selection_notice' | 'statement_of_needs' | 'product_information' | 'pre_existing_conditions' | 'statutory_warning', required
    - `text` string, required — The disclosure statement text.
  - `object` string — Object type identifier

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/kota/apis/kota-api.md) · [All operations](https://skmtc.net/kota/apis/kota-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kota/kota-api/versions/7b8b3ed87c96/schema)