---
title: "Paycode data model"
url: "https://docs.unified.to/hris/paycode/model"
description: "The Paycode data model object in Unified's Paycode API: 14 fields, including created_at, updated_at and company_id, with types and enum values."
date: "2026-10-20T01:36:58.058Z"
updated: "2026-11-20T13:55:39.351Z"
---
# Paycode data model

Updated: November 20, 2026

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](https://docs.unified.to/hris/integrations.md) 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)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| company\_id              | string             | No       | (reference to HrisCompany)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| name                     | string             | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| code                     | string             | No       | the payroll system's code for this item                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| description              | string             | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| type                     | enum               | No       | Values: EARNING, DEDUCTION, TAX, CONTRIBUTION, REIMBURSEMENT                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| detail\_type             | enum               | No       | the normalized payslip-line type this code produces Values: EARNING\_SALARY, EARNING\_OVERTIME, EARNING\_TIP, EARNING\_BONUS, EARNING\_COMMISSION, EARNING\_ADJUSTMENT, EARNING, PRETAX\_DEDUCTION, PRETAX\_DEDUCTION\_HEALTH\_INSURANCE, PRETAX\_DEDUCTION\_RETIREMENT, PRETAX\_DEDUCTION\_HRA, TAX\_FEDERAL, TAX\_REGION, TAX\_LOCAL, POSTTAX\_BENEFIT, POSTTAX\_GARNISHMENT, REIMBURSEMENT, EARNING\_REGULAR, EARNING\_DOUBLE\_OVERTIME, EARNING\_PTO, EARNING\_SICK, EARNING\_HOLIDAY, EARNING\_SEVERANCE, EARNING\_REIMBURSEMENT, TAX\_SOCIAL\_SECURITY, TAX\_MEDICARE, TAX\_UNEMPLOYMENT, TAX\_EMPLOYER, PRETAX\_DEDUCTION\_HSA, PRETAX\_DEDUCTION\_FSA, PRETAX\_DEDUCTION\_DEPENDENT\_CARE, PRETAX\_DEDUCTION\_COMMUTER, PRETAX\_DEDUCTION\_DENTAL, PRETAX\_DEDUCTION\_VISION, POSTTAX\_DEDUCTION, POSTTAX\_RETIREMENT\_ROTH, POSTTAX\_LOAN\_REPAYMENT, EMPLOYER\_CONTRIBUTION, PENSION, EARNING\_CASH\_IN\_LIEU, PRETAX\_DEDUCTION\_RETIREMENT\_CATCHUP, POSTTAX\_RETIREMENT\_ROTH\_CATCHUP, POSTTAX\_RETIREMENT\_AFTER\_TAX, EMPLOYER\_CONTRIBUTION\_RETIREMENT, EMPLOYER\_CONTRIBUTION\_HSA, EMPLOYER\_CONTRIBUTION\_FSA, POSTTAX\_DEDUCTION\_COLLEGE\_SAVINGS, POSTTAX\_DEDUCTION\_UNION\_DUES, POSTTAX\_DEDUCTION\_EWA\_REPAYMENT |
| is\_pre\_tax             | boolean            | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| is\_employer             | boolean            | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| is\_active               | boolean            | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| is\_retirement\_eligible | boolean            | No       | true when earnings under this code count as retirement-plan compensation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| metadata                 | HrisMetadata\[\]   | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| metadata\[\].id          | string             | No       | The ID of the custom field definition (from the metadata/metadata endpoint).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| metadata\[\].value       | object             | No       | The field's value, typed by format: DATE as ISO-8601 (YYYY-MM-DD, or YYYY-MM-DDTHH:MM:SSZ for date-times); NUMBER, PRICE and CURRENCY as a number; BOOLEAN and YES\_NO as true/false; MULTIPLE\_SELECT as an array of option values; otherwise a string.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| metadata\[\].namespace   | string             | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| metadata\[\].format      | enum               | No       | The data type of the custom field, which determines how value is formatted. Values: TEXT, NUMBER, DATE, BOOLEAN, FILE, TEXTAREA, SINGLE\_SELECT, MULTIPLE\_SELECT, MEASUREMENT, PRICE, YES\_NO, CURRENCY, URL                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| metadata\[\].extra\_data | object             | No       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| metadata\[\].slug        | string             | No       | The integration's API name (key) of an existing custom field. List valid slugs for this object with the metadata/metadata endpoint; unknown slugs are rejected by the integration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

## TypeScript

```typescript
export type HrisPaycode = {
	id?: string;
	created_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	updated_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	company_id?: string; // (reference to HrisCompany)
	name?: string;
	code?: string; // the payroll system's code for this item
	description?: string;
	type?: 'EARNING' | 'DEDUCTION' | 'TAX' | 'CONTRIBUTION' | 'REIMBURSEMENT';
	detail_type?: 'EARNING_SALARY' | 'EARNING_OVERTIME' | 'EARNING_TIP' | 'EARNING_BONUS' | 'EARNING_COMMISSION' | 'EARNING_ADJUSTMENT' | 'EARNING' | 'PRETAX_DEDUCTION' | 'PRETAX_DEDUCTION_HEALTH_INSURANCE' | 'PRETAX_DEDUCTION_RETIREMENT' | 'PRETAX_DEDUCTION_HRA' | 'TAX_FEDERAL' | 'TAX_REGION' | 'TAX_LOCAL' | 'POSTTAX_BENEFIT' | 'POSTTAX_GARNISHMENT' | 'REIMBURSEMENT' | 'EARNING_REGULAR' | 'EARNING_DOUBLE_OVERTIME' | 'EARNING_PTO' | 'EARNING_SICK' | 'EARNING_HOLIDAY' | 'EARNING_SEVERANCE' | 'EARNING_REIMBURSEMENT' | 'TAX_SOCIAL_SECURITY' | 'TAX_MEDICARE' | 'TAX_UNEMPLOYMENT' | 'TAX_EMPLOYER' | 'PRETAX_DEDUCTION_HSA' | 'PRETAX_DEDUCTION_FSA' | 'PRETAX_DEDUCTION_DEPENDENT_CARE' | 'PRETAX_DEDUCTION_COMMUTER' | 'PRETAX_DEDUCTION_DENTAL' | 'PRETAX_DEDUCTION_VISION' | 'POSTTAX_DEDUCTION' | 'POSTTAX_RETIREMENT_ROTH' | 'POSTTAX_LOAN_REPAYMENT' | 'EMPLOYER_CONTRIBUTION' | 'PENSION' | 'EARNING_CASH_IN_LIEU' | 'PRETAX_DEDUCTION_RETIREMENT_CATCHUP' | 'POSTTAX_RETIREMENT_ROTH_CATCHUP' | 'POSTTAX_RETIREMENT_AFTER_TAX' | 'EMPLOYER_CONTRIBUTION_RETIREMENT' | 'EMPLOYER_CONTRIBUTION_HSA' | 'EMPLOYER_CONTRIBUTION_FSA' | 'POSTTAX_DEDUCTION_COLLEGE_SAVINGS' | 'POSTTAX_DEDUCTION_UNION_DUES' | 'POSTTAX_DEDUCTION_EWA_REPAYMENT'; // the normalized payslip-line type this code produces
	is_pre_tax?: boolean;
	is_employer?: boolean;
	is_active?: boolean;
	is_retirement_eligible?: boolean; // true when earnings under this code count as retirement-plan compensation
	metadata?: [];
	raw?: any;
} 
```

## Zod

```typescript
import { z } from 'zod';

export const ZodHrisPaycode = z.object({
	id: z.string().optional(),
	created_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	updated_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	company_id: z.string().optional().describe("(reference to HrisCompany)"),
	name: z.string().optional(),
	code: z.string().optional().describe("the payroll system's code for this item"),
	description: z.string().optional(),
	type: z.enum("EARNING", "DEDUCTION", "TAX", "CONTRIBUTION", "REIMBURSEMENT").optional(),
	detail_type: z.enum("EARNING_SALARY", "EARNING_OVERTIME", "EARNING_TIP", "EARNING_BONUS", "EARNING_COMMISSION", "EARNING_ADJUSTMENT", "EARNING", "PRETAX_DEDUCTION", "PRETAX_DEDUCTION_HEALTH_INSURANCE", "PRETAX_DEDUCTION_RETIREMENT", "PRETAX_DEDUCTION_HRA", "TAX_FEDERAL", "TAX_REGION", "TAX_LOCAL", "POSTTAX_BENEFIT", "POSTTAX_GARNISHMENT", "REIMBURSEMENT", "EARNING_REGULAR", "EARNING_DOUBLE_OVERTIME", "EARNING_PTO", "EARNING_SICK", "EARNING_HOLIDAY", "EARNING_SEVERANCE", "EARNING_REIMBURSEMENT", "TAX_SOCIAL_SECURITY", "TAX_MEDICARE", "TAX_UNEMPLOYMENT", "TAX_EMPLOYER", "PRETAX_DEDUCTION_HSA", "PRETAX_DEDUCTION_FSA", "PRETAX_DEDUCTION_DEPENDENT_CARE", "PRETAX_DEDUCTION_COMMUTER", "PRETAX_DEDUCTION_DENTAL", "PRETAX_DEDUCTION_VISION", "POSTTAX_DEDUCTION", "POSTTAX_RETIREMENT_ROTH", "POSTTAX_LOAN_REPAYMENT", "EMPLOYER_CONTRIBUTION", "PENSION", "EARNING_CASH_IN_LIEU", "PRETAX_DEDUCTION_RETIREMENT_CATCHUP", "POSTTAX_RETIREMENT_ROTH_CATCHUP", "POSTTAX_RETIREMENT_AFTER_TAX", "EMPLOYER_CONTRIBUTION_RETIREMENT", "EMPLOYER_CONTRIBUTION_HSA", "EMPLOYER_CONTRIBUTION_FSA", "POSTTAX_DEDUCTION_COLLEGE_SAVINGS", "POSTTAX_DEDUCTION_UNION_DUES", "POSTTAX_DEDUCTION_EWA_REPAYMENT").optional().describe("the normalized payslip-line type this code produces"),
	is_pre_tax: z.boolean().optional(),
	is_employer: z.boolean().optional(),
	is_active: z.boolean().optional(),
	is_retirement_eligible: z.boolean().optional().describe("true when earnings under this code count as retirement-plan compensation"),
	metadata: z.array().optional(),

});
```

## Python

```python
import dataclasses

@dataclasses.dataclass
class HrisPaycodeType(str, Enum):
	EARNING = 'EARNING'
	DEDUCTION = 'DEDUCTION'
	TAX = 'TAX'
	CONTRIBUTION = 'CONTRIBUTION'
	REIMBURSEMENT = 'REIMBURSEMENT'

@dataclasses.dataclass
class HrisPaycodeDetail_type(str, Enum):
	EARNING_SALARY = 'EARNING_SALARY'
	EARNING_OVERTIME = 'EARNING_OVERTIME'
	EARNING_TIP = 'EARNING_TIP'
	EARNING_BONUS = 'EARNING_BONUS'
	EARNING_COMMISSION = 'EARNING_COMMISSION'
	EARNING_ADJUSTMENT = 'EARNING_ADJUSTMENT'
	EARNING = 'EARNING'
	PRETAX_DEDUCTION = 'PRETAX_DEDUCTION'
	PRETAX_DEDUCTION_HEALTH_INSURANCE = 'PRETAX_DEDUCTION_HEALTH_INSURANCE'
	PRETAX_DEDUCTION_RETIREMENT = 'PRETAX_DEDUCTION_RETIREMENT'
	PRETAX_DEDUCTION_HRA = 'PRETAX_DEDUCTION_HRA'
	TAX_FEDERAL = 'TAX_FEDERAL'
	TAX_REGION = 'TAX_REGION'
	TAX_LOCAL = 'TAX_LOCAL'
	POSTTAX_BENEFIT = 'POSTTAX_BENEFIT'
	POSTTAX_GARNISHMENT = 'POSTTAX_GARNISHMENT'
	REIMBURSEMENT = 'REIMBURSEMENT'
	EARNING_REGULAR = 'EARNING_REGULAR'
	EARNING_DOUBLE_OVERTIME = 'EARNING_DOUBLE_OVERTIME'
	EARNING_PTO = 'EARNING_PTO'
	EARNING_SICK = 'EARNING_SICK'
	EARNING_HOLIDAY = 'EARNING_HOLIDAY'
	EARNING_SEVERANCE = 'EARNING_SEVERANCE'
	EARNING_REIMBURSEMENT = 'EARNING_REIMBURSEMENT'
	TAX_SOCIAL_SECURITY = 'TAX_SOCIAL_SECURITY'
	TAX_MEDICARE = 'TAX_MEDICARE'
	TAX_UNEMPLOYMENT = 'TAX_UNEMPLOYMENT'
	TAX_EMPLOYER = 'TAX_EMPLOYER'
	PRETAX_DEDUCTION_HSA = 'PRETAX_DEDUCTION_HSA'
	PRETAX_DEDUCTION_FSA = 'PRETAX_DEDUCTION_FSA'
	PRETAX_DEDUCTION_DEPENDENT_CARE = 'PRETAX_DEDUCTION_DEPENDENT_CARE'
	PRETAX_DEDUCTION_COMMUTER = 'PRETAX_DEDUCTION_COMMUTER'
	PRETAX_DEDUCTION_DENTAL = 'PRETAX_DEDUCTION_DENTAL'
	PRETAX_DEDUCTION_VISION = 'PRETAX_DEDUCTION_VISION'
	POSTTAX_DEDUCTION = 'POSTTAX_DEDUCTION'
	POSTTAX_RETIREMENT_ROTH = 'POSTTAX_RETIREMENT_ROTH'
	POSTTAX_LOAN_REPAYMENT = 'POSTTAX_LOAN_REPAYMENT'
	EMPLOYER_CONTRIBUTION = 'EMPLOYER_CONTRIBUTION'
	PENSION = 'PENSION'
	EARNING_CASH_IN_LIEU = 'EARNING_CASH_IN_LIEU'
	PRETAX_DEDUCTION_RETIREMENT_CATCHUP = 'PRETAX_DEDUCTION_RETIREMENT_CATCHUP'
	POSTTAX_RETIREMENT_ROTH_CATCHUP = 'POSTTAX_RETIREMENT_ROTH_CATCHUP'
	POSTTAX_RETIREMENT_AFTER_TAX = 'POSTTAX_RETIREMENT_AFTER_TAX'
	EMPLOYER_CONTRIBUTION_RETIREMENT = 'EMPLOYER_CONTRIBUTION_RETIREMENT'
	EMPLOYER_CONTRIBUTION_HSA = 'EMPLOYER_CONTRIBUTION_HSA'
	EMPLOYER_CONTRIBUTION_FSA = 'EMPLOYER_CONTRIBUTION_FSA'
	POSTTAX_DEDUCTION_COLLEGE_SAVINGS = 'POSTTAX_DEDUCTION_COLLEGE_SAVINGS'
	POSTTAX_DEDUCTION_UNION_DUES = 'POSTTAX_DEDUCTION_UNION_DUES'
	POSTTAX_DEDUCTION_EWA_REPAYMENT = 'POSTTAX_DEDUCTION_EWA_REPAYMENT'

@dataclasses.dataclass
class HrisPaycode:
	id: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	created_at: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	updated_at: Optional[str]
	"""(reference to HrisCompany)"""
	company_id: Optional[str]
	name: Optional[str]
	"""the payroll system's code for this item"""
	code: Optional[str]
	description: Optional[str]
	type: Optional[HrisPaycodeType]
	"""the normalized payslip-line type this code produces"""
	detail_type: Optional[HrisPaycodeDetail_type]
	is_pre_tax: Optional[bool]
	is_employer: Optional[bool]
	is_active: Optional[bool]
	"""true when earnings under this code count as retirement-plan compensation"""
	is_retirement_eligible: Optional[bool]
	metadata: Optional[PropertyHrisPaycodeMetadata]

```
