---
title: "Benefit data model"
url: "https://docs.unified.to/hris/benefit/model"
description: "API reference for Benefit data model. Launch multiple pre-built Benefit integrations today with zero maintenance — all through a single API."
generated_at: "2026-07-04T01:54:12.221Z"
---
# Benefit data model

Company-wide benefit plans available to employees.

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/hris/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

**created\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**name**string 

e.g. "401(k) Plan"

**description**string 

e.g. "Company 401(k) retirement plan"

**company\_id**string 

(reference to HrisCompany)

**type** enum

Valid values:

 "RETIREMENT" 

 "HEALTH" 

 "DENTAL" 

 "VISION" 

 "LIFE" 

**tax** enum

Valid values:

 "PRE\_TAX" 

 "POST\_TAX" 

 "TAXABLE" 

 "NON\_TAXABLE" 

 "TAX" 

Tax describes the tax treatment of the benefit

**frequency** enum

Valid values:

 "ONE\_TIME" 

 "DAY" 

 "QUARTER" 

 "YEAR" 

 "HOUR" 

Frequency that costs accrue for this benefit. For insurance/benefits, usually "MONTHLY". For compensation, matches pay cycle (WEEKLY, BIWEEKLY, etc).

**is\_active**boolean 

**employer\_contribution\_type** enum

Valid values:

 "PERCENTAGE" 

 "FIXED" 

**employer\_contribution\_amount**number 

percentage or money

**employer\_contribution\_max\_amount**number 

always money

**coverage\_level** enum

Valid values:

 "EMPLOYEE\_ONLY" 

 "EMPLOYEE\_SPOUSE" 

 "EMPLOYEE\_CHILD" 

 "EMPLOYEE\_CHILDREN" 

 "EMPLOYEE\_FAMILY" 

**currency**string 

**raw**any