Employers

List an employer's ACA full-time employees

Returns the employer's employees who currently have an ACA full-time determination, with their designated (payroll) and ACA classifications, required coverage start date, and measurement/stability period windows.caller must be authorized for the employer. Responds 422 with app_error_code aca_autopilot_not_entitled when the employer's plan doesn't include ACA Autopilot, or aca_policy_not_configured when it does but no ACA policy is set up.

get/v1/employers/{employer_id}/aca-full-time-employees

Request

  • Base URL: https://api.vitablehealth.com
  • URL: https://api.vitablehealth.com/v1/employers/{employer_id}/aca-full-time-employees
  • Auth: HTTP bearer

Path parameters

employer_idstring required

Unique employer identifier (empr_*)

Query parameters

aca_classification'FULL_TIME'

Filters to an exact ACA classification.

limitinteger

Items per page (default: 20, max: 100)

namestring

Filters to employees whose first or last name contains this text (case-insensitive).

pageinteger

Page number (default: 1)

Headers

X-Vitable-Organizationstring

Organization to act as for this request (e.g. org_SGVsbG8gV29ybGQ). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 organization_required. A malformed value returns 400 invalid_organization_header, and naming an organization you do not have access to returns 403 organization_access_denied.

Response

Changes

No recorded changes to this operation across all 1 revision of this API.