latestSwagger 2.02026-08-0982147352.7 KB

be66ed178abe

Enrollment

employee enrollments

Enrollments for a type of plan.<p>Scopes: export_enrollment</p>

get/v{version}/companies/{company_id}/enrollments

Path parameters

company_idstring required

Id of the company.

versionstring required

Query parameters

plan_typestring required

The plan type. Please see <a href="/api/docs/v2#section/Plan-Types">Plan Types</a> for a complete list of supported values.

from_datestring required

The date to begin from, inclusive.

to_datestring required

The date to end at, inclusive. The maximum time period allowed is 2 years.

employee_start_idstring

The employee id to start with. Optional.

employee_limitinteger

Limits the number of employees returned. Optional. The default is 50 and the maximum value is 250.

costs_deduction_period'Default' | 'Monthly' | 'Weekly' | 'PayCycle'

The deduction period used for cost calculations.

include_voidedboolean

Indicates whether or not to include voided enrollments. Optional. The default is false.

Response

Success

next_idstring

The id of the object next up after this set.

errorstring

Contains any error messages, if applicable.

Example response

{
  "data": [
    {
      "effective_date": "yyyy-MM-dd",
      "signature_date": "yyyy-MM-dd",
      "original_effective_date": "yyyy-MM-dd",
      "life_event_date": "yyyy-MM-dd",
      "coverages": [
        {
          "effective_date": "yyyy-MM-dd",
          "termination_date": "yyyy-MM-dd",
          "last_coverage_date": "yyyy-MM-dd",
          "life_event": {
            "date": "yyyy-MM-dd",
            "create_date": "yyyy-MM-dd",
            "last_modified_date": "yyyy-MM-dd"
          }
        }
      ],
      "plan": {
        "start_date": "yyyy-MM-dd",
        "end_date": "yyyy-MM-dd"
      },
      "activity_date": "yyyy-MM-dd",
      "change_date": "yyyy-MM-dd"
    }
  ]
}