---
title: "List all policies"
method: GET
path: "/policies"
tags: ["Policies"]
---

# List all policies

`GET /policies`

Returns a list of `policies`. By default, only `active` and `scheduled` policies are returned. Use the `status` query parameter to filter by other statuses. The `policies` are returned sorted by creation date, with the most recent `policy` appearing first.

## Query parameters

- `employee_id` string — Filters policies by employee.
- `group_id` string — Filters policies by group.
- `group_policy_id` string — Filters policies by group policy.
- `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

- PolicyResponsePagedList
  - `items` PolicyResponse[], required — A paginated array containing the response elements
    - `id` string, required — Unique identifier for the policy. Prefixed with `p_`.
    - `employee_id` string, required — Identifier of the employee associated with this policy. Prefixed with `ee_`.
    - `group_policy_id` string, required — Identifier of the group policy id associated with this policy. Prefixed with `gp_`.
    - `bundling_type` 'not_bundled' | 'bundled_primary' | 'bundled_secondary', required
    - `status` 'scheduled' | 'active' | 'expired' | 'cancelled', required
    - `group_id` string, required — Identifier of the group associated with this policy. Prefixed with `gr_`.
    - `provider` PolicyProviderResponse, required
      - `id` string, required — Unique identifier for the provider. Prefixed with pr_.
      - `name` string, required — Provider display name.
      - `description` string, required — Short description of the provider.
      - `logo_url` string, required
      - `employer_portal_url` string, nullable — URL for the employer portal.
      - `employee_portal_url` string, nullable — URL for the employee portal (may include claims management).
      - `support_phone_number` string, nullable — Provider support phone number in E.164 format.
    - `plan` PolicyPlanResponse, required
      - `id` string, required — Unique identifier for the plan. Prefixed with pl_.
      - `name` string, required — Plan display name.
      - `description` string, required — Short description of the plan.
      - `currency` 'eur' | 'aed' | 'afn' | 'xcd' | 'all' | 'amd' | 'aoa' | 'ars' | 'usd' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'xof' | 'bgn' | 'bhd' | 'bif' | 'bmd' | 'bnd' | 'bob' | 'bov' | 'brl' | 'bsd' | 'inr' | 'btn' | 'nok' | 'bwp' | 'byn' | 'bzd' | 'cad' | 'xaf' | 'cdf' | 'chf' | 'che' | 'chw' | 'nzd' | 'clp' | 'clf' | 'cny' | 'cop' | 'cou' | 'crc' | 'cup' | 'cuc' | 'cve' | 'ang' | 'czk' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'mad' | 'ern' | 'etb' | 'fjd' | 'fkp' | 'mdl' | 'gbp' | 'gel' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'hrk' | 'htg' | 'huf' | 'idr' | 'xdr' | 'ils' | 'iqd' | 'irr' | 'isk' | 'jmd' | 'jod' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'kpw' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'zar' | 'lyd' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mru' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mxv' | 'myr' | 'mzn' | 'nad' | 'xpf' | 'ngn' | 'nio' | 'npr' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pkr' | 'pln' | 'pyg' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sdg' | 'sek' | 'sgd' | 'shp' | 'sll' | 'sos' | 'srd' | 'ssp' | 'stn' | 'svc' | 'xsu' | 'syp' | 'twd' | 'szl' | 'thb' | 'tjs' | 'tmt' | 'tnd' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'ugx' | 'usn' | 'uyu' | 'uyi' | 'uyw' | 'uzs' | 'ves' | 'vnd' | 'vuv' | 'wst' | 'yer' | 'xua' | 'zmw' | 'zwl', required
      - `documents` PlanDocumentResponse[], required — List of plan documents (e.g., IPIDs, T&Cs).
        - `type` 'ipid' | 'table_of_cover' | 'waiting_periods' | 'hospital_list' | 'plan_summary' | 'terms_and_conditions' | 'other'
        - `title` string, required — Title of the document.
        - `link` string, required — Public URL to the document. This could be any format (PDF, HTML, etc.).
    - `start_date` string, date, required — Policy start (effective) date in ISO 8601 (YYYY-MM-DD)
    - `end_date` string, date, nullable — Policy end date (inclusive) in ISO 8601, or null if open-ended
    - `cancellation_date` string, date, nullable — Date the policy was cancelled (if applicable)
    - `type` 'health_insurance' | 'life_assurance', required
    - `health_insurance` HealthInsurancePolicyResponse
      - `policy_number` string, nullable — Provider-issued policy number for health insurance
      - `opt_out_deadline` string, date, required — Deadline for opting out of the policy. Members cannot opt out after this date.
      - `initial_dependents_update_deadline` string, date, nullable, required — Represents the last date to add or remove dependents during the initial adjustment period. The deadline date is inclusive (changes are allowed on that date). This value should be evaluated using the local time zone where the policy is active. Returns null when the provider doesn't support dependent modifications during the initial adjustment period.
      - `renewal` HealthInsurancePolicyRenewalResponse, required
        - `renewal_date` string, date, required — Renewal date.
        - `window_start_date` string, date, required — Renewal window start (inclusive).
        - `window_end_date` string, date, required — Renewal window end (inclusive).
        - `status` 'upcoming' | 'open' | 'renewed' | 'cancelled', required
        - `renewed_policy_id` string, nullable — Identifier of the renewed policy. This means existing policy will be replaced by the renewed policy on the renewal date.
      - `dependents_supported` boolean, required — Whether this policy supports adding or removing dependents.
      - `configuration` HealthInsurancePolicyConfigurationResponse, required
        - `cost_sharing` HealthInsuranceCostSharingConfigurationResponse, required
          - `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
      - `members` PolicyMemberResponse[], required — List of members on the health insurance policy
        - `id` string, required — Unique identifier for the policy member. Prefixed with `pm_`.
        - `member_number` string, nullable — Provider-issued member number, null if not issues yet
        - `first_name` string, required — First name of the member
        - `last_name` string, required — Last name of the member
        - `date_of_birth` string, date, required — Date of birth of the member
        - `sex_at_birth` 'male' | 'female', required
        - `member_type` 'policyholder' | 'spouse' | 'partner' | 'adult_dependant' | 'child', required
        - `associated_person_id` string, nullable — Identifier of the associated person. Not present for policyholders. Prefixed with `ap_`.
      - `estimated_gross_premium` HealthInsurancePolicyEstimatedGrossPremiumResponse, required
        - `currency` 'eur' | 'aed' | 'afn' | 'xcd' | 'all' | 'amd' | 'aoa' | 'ars' | 'usd' | 'aud' | 'awg' | 'azn' | 'bam' | 'bbd' | 'bdt' | 'xof' | 'bgn' | 'bhd' | 'bif' | 'bmd' | 'bnd' | 'bob' | 'bov' | 'brl' | 'bsd' | 'inr' | 'btn' | 'nok' | 'bwp' | 'byn' | 'bzd' | 'cad' | 'xaf' | 'cdf' | 'chf' | 'che' | 'chw' | 'nzd' | 'clp' | 'clf' | 'cny' | 'cop' | 'cou' | 'crc' | 'cup' | 'cuc' | 'cve' | 'ang' | 'czk' | 'djf' | 'dkk' | 'dop' | 'dzd' | 'egp' | 'mad' | 'ern' | 'etb' | 'fjd' | 'fkp' | 'mdl' | 'gbp' | 'gel' | 'ghs' | 'gip' | 'gmd' | 'gnf' | 'gtq' | 'gyd' | 'hkd' | 'hnl' | 'hrk' | 'htg' | 'huf' | 'idr' | 'xdr' | 'ils' | 'iqd' | 'irr' | 'isk' | 'jmd' | 'jod' | 'jpy' | 'kes' | 'kgs' | 'khr' | 'kmf' | 'kpw' | 'krw' | 'kwd' | 'kyd' | 'kzt' | 'lak' | 'lbp' | 'lkr' | 'lrd' | 'lsl' | 'zar' | 'lyd' | 'mga' | 'mkd' | 'mmk' | 'mnt' | 'mop' | 'mru' | 'mur' | 'mvr' | 'mwk' | 'mxn' | 'mxv' | 'myr' | 'mzn' | 'nad' | 'xpf' | 'ngn' | 'nio' | 'npr' | 'omr' | 'pab' | 'pen' | 'pgk' | 'php' | 'pkr' | 'pln' | 'pyg' | 'qar' | 'ron' | 'rsd' | 'rub' | 'rwf' | 'sar' | 'sbd' | 'scr' | 'sdg' | 'sek' | 'sgd' | 'shp' | 'sll' | 'sos' | 'srd' | 'ssp' | 'stn' | 'svc' | 'xsu' | 'syp' | 'twd' | 'szl' | 'thb' | 'tjs' | 'tmt' | 'tnd' | 'top' | 'try' | 'ttd' | 'tzs' | 'uah' | 'ugx' | 'usn' | 'uyu' | 'uyi' | 'uyw' | 'uzs' | 'ves' | 'vnd' | 'vuv' | 'wst' | 'yer' | 'xua' | 'zmw' | 'zwl', required
        - `monthly` HealthInsurancePolicyGrossEstimationAmountResponse, required
          - `employee_contribution` number, double, required — Estimated gross premium amount deducted from employee payroll
          - `employer_contribution` number, double, required — Estimated gross premium amount paid by the employer
          - `total` number, double, required — Total gross premium amount (sum of employee and employer contributions).
        - `term` HealthInsurancePolicyGrossEstimationAmountResponse, required
          - `employee_contribution` number, double, required — Estimated gross premium amount deducted from employee payroll
          - `employer_contribution` number, double, required — Estimated gross premium amount paid by the employer
          - `total` number, double, required — Total gross premium amount (sum of employee and employer contributions).
    - `disclosures` DisclosureResponse[], required — Disclosures associated with this policy.
      - `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
  - `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/revisions/85bb8b3c42b4/schema)