---
title: "Retrieve a plan"
method: GET
path: "/plans/{plan_id}"
tags: ["Plans"]
---

# Retrieve a plan

`GET /plans/{plan_id}`

Retrieves a `plan` object by its ID.

## Path parameters

- `plan_id` string, required

## Query parameters

- `group_id` string — When provided together with `start_date`, per-plan eligibility counts are included in the response. Silently ignored if not paired with `start_date`.
- `start_date` string, date — Reference date used to compute employee age when evaluating eligibility. Required together with `group_id` for counts to be included.

## Headers

- `X-Platform-Id` string

## Response `200`

OK

- PlanResponse
  - `object` string — Object type. Always `plan`.
  - `id` string, required — Unique identifier for the plan. Prefixed with `pl_`.
  - `type` 'health_insurance', required
  - `name` string, required — The name of the plan.
  - `description` string, required — Description of the plan.
  - `country` 'af' | 'ax' | 'al' | 'dz' | 'as' | 'ad' | 'ao' | 'ai' | 'aq' | 'ag' | 'ar' | 'am' | 'aw' | 'au' | 'at' | 'az' | 'bs' | 'bh' | 'bd' | 'bb' | 'by' | 'be' | 'bz' | 'bj' | 'bm' | 'bt' | 'bo' | 'bq' | 'ba' | 'bw' | 'bv' | 'br' | 'io' | 'bn' | 'bg' | 'bf' | 'bi' | 'cv' | 'kh' | 'cm' | 'ca' | 'ky' | 'cf' | 'td' | 'cl' | 'cn' | 'cx' | 'cc' | 'co' | 'km' | 'cg' | 'cd' | 'ck' | 'cr' | 'ci' | 'hr' | 'cu' | 'cw' | 'cy' | 'cz' | 'dk' | 'dj' | 'dm' | 'do' | 'ec' | 'eg' | 'sv' | 'gq' | 'er' | 'ee' | 'sz' | 'et' | 'fk' | 'fo' | 'fj' | 'fi' | 'fr' | 'gf' | 'pf' | 'tf' | 'ga' | 'gm' | 'ge' | 'de' | 'gh' | 'gi' | 'gr' | 'gl' | 'gd' | 'gp' | 'gu' | 'gt' | 'gg' | 'gn' | 'gw' | 'gy' | 'ht' | 'hm' | 'va' | 'hn' | 'hk' | 'hu' | 'is' | 'in' | 'id' | 'ir' | 'iq' | 'ie' | 'im' | 'il' | 'it' | 'jm' | 'jp' | 'je' | 'jo' | 'kz' | 'ke' | 'ki' | 'kp' | 'kr' | 'xk' | 'kw' | 'kg' | 'la' | 'lv' | 'lb' | 'ls' | 'lr' | 'ly' | 'li' | 'lt' | 'lu' | 'mo' | 'mg' | 'mw' | 'my' | 'mv' | 'ml' | 'mt' | 'mh' | 'mq' | 'mr' | 'mu' | 'yt' | 'mx' | 'fm' | 'md' | 'mc' | 'mn' | 'me' | 'ms' | 'ma' | 'mz' | 'mm' | 'na' | 'nr' | 'np' | 'nl' | 'nc' | 'nz' | 'ni' | 'ne' | 'ng' | 'nu' | 'nf' | 'mk' | 'mp' | 'no' | 'om' | 'pk' | 'pw' | 'ps' | 'pa' | 'pg' | 'py' | 'pe' | 'ph' | 'pn' | 'pl' | 'pt' | 'pr' | 'qa' | 're' | 'ro' | 'ru' | 'rw' | 'bl' | 'sh' | 'kn' | 'lc' | 'mf' | 'pm' | 'vc' | 'ws' | 'sm' | 'st' | 'sa' | 'sn' | 'rs' | 'sc' | 'sl' | 'sg' | 'sx' | 'sk' | 'si' | 'sb' | 'so' | 'za' | 'gs' | 'ss' | 'es' | 'lk' | 'sd' | 'sr' | 'sj' | 'se' | 'ch' | 'sy' | 'tw' | 'tj' | 'tz' | 'th' | 'tl' | 'tg' | 'tk' | 'to' | 'tt' | 'tn' | 'tr' | 'tm' | 'tc' | 'tv' | 'ug' | 'ua' | 'ae' | 'gb' | 'um' | 'us' | 'uy' | 'uz' | 'vu' | 've' | 'vn' | 'vg' | 'vi' | 'wf' | 'eh' | 'ye' | 'zm' | 'zw', required
  - `provider` PlanProviderResponse, required
    - `id` string, required — Unique identifier for the provider. Prefixed with `pr_`.
    - `name` string, required — The name of the provider.
    - `description` string, required — Description of the provider.
    - `logo_url` string, required — URL to the provider's logo.
  - `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.).
  - `employer_eligibility_criteria` EmployerEligibilityCriterionResponse[], required — Eligibility criteria that employers must meet.
    - `type` 'employees_count' | 'members_count' | 'industry_exclusions', required
    - `description` string, required — Human-readable description of the criterion.
    - `employees_count` EmployeesCountDetails
      - `min` integer, nullable — Minimum number of employees required.
      - `max` integer, nullable — Maximum number of employees allowed.
    - `members_count` MembersCountDetails
      - `min` integer, nullable — Minimum number of members required.
      - `max` integer, nullable — Maximum number of members allowed.
    - `industry_exclusions` IndustryExclusionsDetails
      - `excluded_industries` string[], required — List of excluded industries.
  - `employee_eligibility_criteria` EmployeeEligibilityCriterionResponse[], required — Eligibility criteria that employees must meet.
    - `type` 'age_range', required
    - `description` string, required — Human-readable description of the criterion.
    - `age_range` AgeRangeDetails
      - `min` integer, nullable — Minimum age required.
      - `max` integer, nullable — Maximum age allowed.
  - `health_insurance` PlanHealthInsuranceResponse
    - `health_insurance_type` 'international' | 'local', required
    - `supported_cost_sharing_options` CostSharingOption[], required — Cost sharing options supported by this plan.
    - `supported_member_types` MemberType[], required — Member types supported by this plan.
    - `pricing` PlanPricingResponse, required
      - `type` 'per_member' | 'tier_based', required
      - `per_member` PerMemberPricingResponse
        - `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
        - `member_type_pricing` MemberTypePricingResponse[], required — Pricing for each member type.
          - `code` 'adult' | 'young_adult' | 'child', required
          - `display_name` string, required — Display name for the member type.
          - `monthly_premium` number, double, required — Monthly premium amount.
      - `tier_based` TierBasedPricingResponse
        - `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
        - `tiers` PricingTierResponse[], required — Pricing tiers for different family compositions.
          - `code` 'single' | 'couple' | 'single_parent' | 'family', required
          - `display_name` string, required — Display name for the tier.
          - `monthly_premium` number, double, required — Monthly premium amount for this tier.
          - `annual_premium` number, double, required — Annual premium amount for this tier.
          - `display_dependent_requirements` string, required — Description of dependent requirements for this tier.
  - `disclosures` DisclosureResponse[], required — Disclosures associated with this plan.
    - `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.
  - `available_from` string, date, required — The date from which this plan is available (inclusive).
  - `available_to` string, date, nullable — The date until which this plan is available (inclusive). Null if the plan has no end date.
  - `coverage_options` PlanCoverageResponse[], nullable — Coverage options available for this plan, organized by scope and input type.
    - `id` string, required — Unique identifier for the coverage selection. Prefixed with `pc_`.
    - `name` string, required — Title for this coverage selection. Typically used as the display heading.
    - `description` string, nullable — Full description of this coverage selection.
    - `scope` 'group_policy' | 'policy' | 'member', required
    - `input_type` 'single_select' | 'multi_select', required
    - `required` boolean, required — Whether a selection is mandatory.
    - `min_selections` integer, nullable — Minimum required selections (multi-select only).
    - `max_selections` integer, nullable — Maximum allowed selections (multi-select only).
    - `sort_order` integer, nullable — Display ordering hint.
    - `group_label` string, nullable — Optional grouping label for UI rendering. Indicates which coverage selections are best presented together from a UX standpoint.
    - `options` PlanCoverageOptionResponse[], required — Available options within this coverage selection.
      - `id` string, required — Unique identifier for this coverage option. Prefixed with `pco_`.
      - `name` string, required — Display name for this coverage option.
      - `description` string, nullable — Longer explanation of this coverage option.
      - `learn_more_url` string, nullable — Link to learn more about this coverage option.
      - `from_price` number, double, nullable — Lowest applicable monthly price for this coverage option.
      - `benefits` PlanCoverageOptionBenefitResponse[], nullable — Benefit items included with this coverage option.
        - `name` string, required — Benefit name.
        - `description` string, nullable — Benefit description.
      - `sub_options` PlanCoverageOptionResponse[], nullable — Nested sub-options available when this option is selected.
      - `eligibility_criteria` EmployerEligibilityCriterionResponse[], nullable — Eligibility criteria that must be met to select this coverage option.
        - `type` 'employees_count' | 'members_count' | 'industry_exclusions', required
        - `description` string, required — Human-readable description of the criterion.
        - `employees_count` EmployeesCountDetails
          - `min` integer, nullable — Minimum number of employees required.
          - `max` integer, nullable — Maximum number of employees allowed.
        - `members_count` MembersCountDetails
          - `min` integer, nullable — Minimum number of members required.
          - `max` integer, nullable — Maximum number of members allowed.
        - `industry_exclusions` IndustryExclusionsDetails
          - `excluded_industries` string[], required — List of excluded industries.
  - `eligible_count` integer, nullable — Number of employees in the queried group eligible for this plan as-of `start_date`. Only present when both `group_id` and `start_date` query parameters are provided.
  - `ineligible_count` integer, nullable — Number of employees in the queried group ineligible for this plan as-of `start_date`. Only present when both `group_id` and `start_date` query parameters are provided.
  - `total_count` integer, nullable — Total employees in the queried group. Only present when both `group_id` and `start_date` query parameters are provided.

## Other responses

- `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/revisions/7b8b3ed87c96/schema)