---
title: "List group policy intents"
method: GET
path: "/group_policy_intents"
tags: ["Group Policy Intents"]
---

# List group policy intents

`GET /group_policy_intents`

Returns a paginated list of `group_policy_intent`'s. The results are returned sorted by creation date, with the most recent appearing first.

## Query parameters

- `group_id` string — Filter by group ID
- `plan_id` string — Filter by plan ID
- `status` string
- `page` integer — The page of results to return. Defaults to 1 if not provided.
- `page_size` integer — The number of results to return per page. Defaults to 10 if not provided. Maximum value is 100.

## Headers

- `X-Platform-Id` string

## Response `200`

OK

- GroupPolicyIntentResponsePagedList
  - `items` GroupPolicyIntentResponse[], required — A paginated array containing the response elements
    - `id` string, required — Unique identifier for the group policy intent
    - `group_id` string, required — Unique identifier for the group
    - `plan_id` string, required — Unique identifier for the plan
    - `quote_intent_id` string, required — Unique identifier for the group quote intent this policy intent was created from
    - `status` 'processing' | 'action_required' | 'pending_provider_approval' | 'policy_created' | 'expired' | 'provider_rejected' | 'manual_renewal_gathering_required', required
    - `due_date` string, date-time, nullable — Due date for the policy intent
    - `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
    - `action_required` GroupPolicyIntentActionRequiredResponse
      - `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).
    - `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
  - `page` integer, required — The current page of the results
  - `page_size` integer, required — The number of results on this page. This can be different from the requested page size if the total number of results is less than the requested page size
  - `total_count` integer, required — The total number of elements available in the response. This is the total number of elements available across all pages, not just the current page.
  - `has_next_page` boolean — Whether there are more pages available after this page
  - `has_previous_page` boolean — Whether there are more pages available before this page

---

[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)