Retrieve an employer policy

1 curl https://test.api.kota.io/employers/er_3b1333d87d9d4fd6ad83ba7f6b0e951a/health_insurance/policies/erhp_3b1333d87d9d4fd6ad83ba7f6b0e951a \ 2 -H "Authorization: Bearer <token>"

1 { 2 "id": "erhp_3b1333d87d9d4fd6ad83ba7f6b0e951a", 3 "employer_id": "er_3b1333d87d9d4fd6ad83ba7f6b0e951a", 4 "start_date": "2024-12-01", 5 "end_date": "2024-12-01", 6 "status": "scheduled", 7 "enrolment_type": "opt_out", 8 "renewal": { 9 "status": "upcoming", 10 "renewal_date": "2024-12-01", 11 "window_start_date": "2024-12-01", 12 "window_end_date": "2024-12-01", 13 "decision_confirmed": true, 14 "renewed_health_insurance_id": "erhp_3b1333d87d9d4fd6ad83ba7f6b0e951a" 15 }, 16 "employer_cancellation_period_length": 42, 17 "coverage_levels": [ 18 { 19 "plan_id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a", 20 "plan_name": "foo", 21 "plan_currency": "eur", 22 "provider_name": "foo", 23 "provider_logo_url": "foo", 24 "documents": [ 25 { 26 "title": "foo", 27 "link": "foo" 28 } 29 ], 30 "provider_employer_platform_url": "foo", 31 "provider_support_phone": "foo" 32 } 33 ], 34 "object": "foo", 35 "cancellation_date": "2024-12-01", 36 "group_policy_number": "foo" 37 }

Retrieve group’s health insurance policy for an employer by employer_policy_id.

Path parameters

employer_idstringRequiredformat: "er_.+"

employer_policy_idstringRequiredformat: "erhp_.+"

Response

idstringformat: "erhp_.+"

Unique identifier for policy

employer_idstringformat: "er_.+"

The Id of the employer for which the policy is created

start_datestringformat: "date"

Policy starts on this date

end_datestringformat: "date"

Policy ends on this date

statusenum

Current status of policy

Allowed values:

enrolment_typeenum

Enrolment type of the policy

Allowed values:

renewalobject

Renewal information for the policy

employer_cancellation_period_lengthinteger

How many days the employer has to cancel the policy since the policy starts

coverage_levelslist of objects

Represents the available coverage levels for this olicy

objectstring or null

The object type

cancellation_datestring or nullformat: "date"

Policy was cancelled on this date, if cancellation occured

group_policy_numberstring or null

Group’s health insurance policy number, if available

Path parameters

Headers

Response

Errors