---
title: "eligibility rates"
method: PATCH
path: "/v{version}/eligibilities/{id}/rates"
tags: ["Eligibility"]
---

# eligibility rates

`PATCH /v{version}/eligibilities/{id}/rates`

Partially updates eligibility rates.<p>Scopes: import_plan</p>

## Path parameters

- `id` string, required
- `version` string, required

## Request body

- DtosEligibilityRates
  - `rate_type` 'Table' | 'Tier-Table' | 'Tier', required
  - `plan_type` string — The type of the plan. See Plan.Type for more information.
  - `rate_basis` string — The rate basis for a life plan.
  - `rate_adjustment_factor` string — The Rate Adjustment Factor,
  - `per_unit` number, double — The per unit amount for a life plan.
  - `tier_employee` string — Amount for employee. Used when RateType == "Tier". Example: $12.10 or 30%.
  - `tier_spouse` string — Amount for spouse. Used when RateType == "Tier". Example: $12.10 or 30%.
  - `tier_children` string — Amount for children. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_dependents` string — Amount for dependents. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_ee` string — Amount for employee Only. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_es` string — Amount for employee + spouse. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_e_s1c` string — Amount for employee + spouse + 1 child. The rate for child 1. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_e_s2c` string — Amount for employee + spouse + 2 children. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_e_s3c` string — Amount for employee + spouse + 3 children. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_e1c` string — Amount for employee + 1 child. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_e2c` string — Amount for employee + 2 children. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_e3c` string — Amount for employee + 3 children. Used when RateType = "Tier". Example: $12.10 or 30%.
  - `tier_rates_tobacco` string[] — Used when RateType = "Tier". Example: $12.10.
  - `tier_table_rates_ee_only` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eesp` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_e_e1ch` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eech` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_family` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_ee_only_tobacco` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eesp_tobacco` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_e_e1ch_tobacco` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eech_tobacco` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_family_tobacco` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_ee_only_male` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eesp_male` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_e_e1ch_male` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eech_male` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_family_male` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_ee_only_female` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eesp_female` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_e_e1ch_female` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_eech_female` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `tier_table_rates_family_female` string[] — Used when RateType = "Tier-Table". Example: $12.10.
  - `table_columns` 'Rates' | 'Employee & Spouse Rates' | 'Gender Rates' | 'Tobacco Rates' | 'Gender & Tobacco Rates' | 'Employee & Spouse & Tobacco Rates' | 'Employee & Spouse & Child Rates' — Defaults to Rates.
  - `tier_table_columns` 'Rates' | 'Gender Rates' | 'Tobacco Rates' — Defaults to Rates.
  - `table_rates` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_employee` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_spouse` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_employee_tobacco` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_spouse_tobacco` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10 or 30%.
  - `table_child` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_male` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_female` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_tobacco` string[] — Contains the rate table amounts for the employee by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_male_tobacco` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_female_tobacco` string[] — Contains the rate table amounts by age, [0] = {0-17}, [1] = 18, [2] = 19, ..., [62] = 80+. Used when RateType = "Table". Note that the specific configuration will depend on the AgeBandType value. Example: $12.10.
  - `table_child1` string — Amount for 1 child. Used when RateType = "Table". Example: $12.10 or 30%.
  - `table_child2` string — Amount for 2 children. Used when RateType = "Table". Example: $12.10 or 30%.
  - `table_child3` string — Amount for 3 children. Used when RateType = "Table". Example: $12.10 or 30%.
  - `age_band_type` 'All Ages (starting with 0-17)' | 'All Ages' | '5 Year Age Bands' | '10 Year Age Bands' — Age bands for the rates. The default is "All Ages (starting with 0-17)", which starts with 0-17.
  - `base_spouse_age_off_employee` boolean — Base the spouse age off employee age.
  - `base_spouse_tobacco_off_employee` boolean — Base the tobacco spouse age off employee age.
  - `base_adult_children_off_age` boolean — Base the adult children age off their age.
  - `rate_library_plan_id` string — For rates associated with a Rate Library, the external Plan Id for the rate.
  - `rate_library_name` string — For rates associated with a Rate Library, the library name for the rate.

## Response `204`

No Content

---

[API](https://skmtc.net/ease/apis/version-2.md) · [All operations](https://skmtc.net/ease/apis/version-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ease/version-2/revisions/be66ed178abe/schema)