---
title: "List all employer policies"
method: GET
path: "/employers/{employer_id}/health_insurance/policies"
tags: ["Health Insurance"]
---

# List all employer policies

`GET /employers/{employer_id}/health_insurance/policies`

Returns a list of group health insurance `policies` for an `employer`. The `policies` are returned sorted by creation date, with the most recent `policy` appearing first.

## Path parameters

- `employer_id` string, required

## Query parameters

- `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

- EmployerHealthInsurancePolicyResponsePagedList
  - `items` EmployerHealthInsurancePolicyResponse[], required — A paginated array containing the response elements
    - `object` string — The object type
    - `id` string, required — Unique identifier for policy
    - `employer_id` string, required — The Id of the employer for which the policy is created
    - `start_date` string, date, required — Policy starts on this date
    - `end_date` string, date, required — Policy ends on this date
    - `cancellation_date` string, date, nullable — Policy was cancelled on this date, if cancellation occured
    - `group_policy_number` string, nullable — Group’s health insurance policy number, if available
    - `status` 'scheduled' | 'active' | 'expired' | 'cancelled', required
    - `enrolment_type` 'opt_out' | 'opt_in', required
    - `renewal` GetEmployerHealthPolicyRenewal, required
      - `status` 'upcoming' | 'open' | 'renewed' | 'cancelled', required
      - `renewal_date` string, date, required — Policy renewal date
      - `window_start_date` string, date, required — Renewal window starts on this day
      - `window_end_date` string, date, required — Renewal window ends at the end of this day
      - `decision_confirmed` boolean, required — Whether the decision to renew the policy has been confirmed
      - `renewed_health_insurance_id` string, nullable — The ID of the renewed health insurance policy, if renewed
    - `employer_cancellation_period_length` integer, required — How many days the employer has to cancel the policy since the policy starts
    - `coverage_levels` HealthInsuranceCoverageLevelResponse[], required — Represents the available coverage levels for this policy
      - `plan_id` string, required — Unique identifier for the health insurance plan
      - `plan_name` string, required — Name of the health insurance plan
      - `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
      - `provider_name` string, required — Name of the health insurance provider
      - `provider_logo_url` string, required — Logo URL of the health insurance provider
      - `provider_employer_platform_url` string, nullable — URL to the health insurance provider's website for Employer Management
      - `provider_support_phone` string, nullable — Support phone number to the health insurance provider's website for Employer Management
      - `documents` HealthInsuranceCoverageLevelDocumentResponse[], required — Documents related to the health insurance plan, these documents may change at renewal, this includes the documents like `Insurance Product Information Document`, `Hospital Lists`, `Table of Cover` etc
        - `title` string, required — Health Insurance Document Title
        - `link` string, required — Health Insurance Document Link (can be a link to a website or a file path)
  - `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)