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

Employee-specific deduction/benefit enrolment.

 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)

**user\_id**string 

employee ID (reference to HrisEmployee)

**company\_id**string 

(reference to HrisCompany)

**benefit\_id**string 

**amount**number 

percentage or absolute amount (employee's portion)

**type** enum

Valid values:

 "FIXED" 

 "PERCENTAGE" 

**coverage\_level** enum

Valid values:

 "EMPLOYEE\_ONLY" 

 "EMPLOYEE\_SPOUSE" 

 "EMPLOYEE\_CHILD" 

 "EMPLOYEE\_CHILDREN" 

 "EMPLOYEE\_FAMILY" 

Level selected by employee (e.g. "FAMILY", "EMPLOYEE\_ONLY", or other)

**frequency** enum

Valid values:

 "ONE\_TIME" 

 "DAY" 

 "QUARTER" 

 "YEAR" 

 "HOUR" 

Frequency for this deduction (should always be set, matches IHrisBenefit.frequency)

**start\_at**date 

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

**end\_at**date 

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

**is\_active**boolean 

**notes**string 

**raw**any