---
title: "Employee data model"
url: "https://docs.unified.to/hris/employee/model"
description: "API reference for Employee data model. Launch multiple pre-built Employee integrations today with zero maintenance — all through a single API."
generated_at: "2026-05-27T21:01:02.377Z"
---
# Employee data model

 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 

**first\_name**string 

**last\_name**string 

**emails** array 

**title**string 

**manager\_id**string 

**employment\_status** enum

Valid values:

 "ACTIVE" 

 "INACTIVE" 

**gender** enum

Valid values:

 "MALE" 

 "FEMALE" 

 "INTERSEX" 

 "TRANS" 

 "NON\_BINARY" 

**telephones** array 

**date\_of\_birth**date 

YYYYMM/DD

**employee\_number**string 

the company's ID for this employee

**hired\_at**date 

The employee's start date (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**terminated\_at**date 

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

**termination\_reason**string 

**marital\_status** enum

Valid values:

 "MARRIED" 

 "SINGLE" 

**employment\_type** enum

Valid values:

 "FULL\_TIME" 

 "PART\_TIME" 

 "CONTRACTOR" 

 "INTERN" 

 "CONSULTANT" 

**address**object 

**language\_locale**string 

**currency**string 

**timezone**string 

**image\_url**string 

This link expires after 1 hour. 

**company\_id**string 

(reference to HrisCompany)

**pronouns**string 

**employee\_roles** enum array 

Valid values:

 "ADMIN" 

 "MANAGER" 

 "RECRUITER" 

 "SALESREP" 

 "INTERVIEWER" 

**compensation** array 

**salutation**string 

Mr. Mrs. Ms.

**bio**string 

**ssn\_sin**string 

**groups** array 

Which groups/teams/units that this employee/user belongs to. May not have all of the Group fields present, but should have id, name, or email.

**locations** array 

**metadata** array 

**storage\_quota\_allocated**number 

**storage\_quota\_used**number 

**storage\_quota\_available**number 

**relationships** array 

the employee's personal relationships (eg. emergency contacts, spouse, dependants, ...)

**has\_mfa**boolean 

does the user/employee have multi-factor authentication enabled

**timeoff\_days\_total**number 

Total time off allowance for the current leave period, in days (when reported by the provider)

**timeoff\_days\_used**number 

Time off days used or booked in the current leave period (when reported by the provider)

**raw**any