Groups

Check employee eligibility for a group

Changed on

Checks whether an employee qualifies for a group without adding them to it. This is a dry-run eligibility check — the employee is not enrolled or added. The response includes provider and plan information.

post/groups/{group_id}/eligibility_check

Request

  • Base URL
    https://test.api.kota.io
  • URL
    https://test.api.kota.io/groups/{group_id}/eligibility_check
  • Auth
    HTTP bearer

Path parameters

group_idstring required
Example:gr_3b1333d87d9d4fd6ad83ba7f6b0e951a

Request body

employee_idstring required

The employee to check eligibility for.

Example request

{
  "employee_id": "ee_3b1333d87d9d4fd6ad83ba7f6b0e951a"
}

Response

OK

objectstring

The object type.

eligibility_status'pending' | 'eligible' | 'ineligible' required

Example response

{
  "provider": {
    "id": "pr_allianz"
  },
  "plan": {
    "id": "pl_3b1333d87d9d4fd6ad83ba7f6b0e951a"
  }
}

Changes