Benefit data model
Company-wide benefit plans available to employees.
View field support, webhooks, and list parameters for each integration on the Supported Integrations page.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | No | |
created_at | string (date-time) | No | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
updated_at | string (date-time) | No | (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) |
name | string | No | e.g. "401(k) Plan" |
description | string | No | e.g. "Company 401(k) retirement plan" |
company_id | string | No | (reference to HrisCompany) |
type | enum | No | Values: RETIREMENT, HEALTH, DENTAL, VISION, LIFE, HSA, FSA, SHORT_TERM_DISABILITY, LONG_TERM_DISABILITY, WORKERS_COMP, HOUSING_STIPEND, EMPLOYER_TAX_CONTRIBUTION, GARNISHMENT, LOAN_REPAYMENT, CHARITABLE_CONTRIBUTION, OTHER, RETIREMENT_ROTH, COMMUTER, DEPENDENT_CARE, PENSION |
tax | enum | No | Tax describes the tax treatment of the benefit Values: PRE_TAX, POST_TAX, TAXABLE, NON_TAXABLE, TAX |
frequency | enum | No | Frequency that costs accrue for this benefit. For insurance/benefits, usually "MONTHLY". For compensation, matches pay cycle (WEEKLY, BIWEEKLY, etc). Values: ONE_TIME, DAY, QUARTER, YEAR, HOUR, MONTH, WEEK, BIWEEKLY, SEMIMONTHLY |
is_active | boolean | No | |
employer_contribution_type | enum | No | Values: PERCENTAGE, FIXED |
employer_contribution_amount | number | No | percentage or money |
employer_contribution_max_amount | number | No | always money |
coverage_level | enum | No | Values: EMPLOYEE_ONLY, EMPLOYEE_SPOUSE, EMPLOYEE_CHILD, EMPLOYEE_CHILDREN, EMPLOYEE_FAMILY, FAMILY, OTHER |
currency | string | No |
Are we missing anything? Let us know