Skip to content
Get started

Benefit Eligibility Policy

Get eligibility policy details
get/v1/benefit-eligibility-policy/{policy_id}
ModelsExpand Collapse
BenefitEligibilityPolicy = object { id, active, created_at, 7 more }

Serializer for Benefit Eligibility Policy entity.

Eligibility policies define rules that determine which employees qualify for benefits.

id: string

Unique eligibility policy identifier with 'epol_' prefix

active: boolean

Whether this policy is currently active

created_at: string

Timestamp when the policy was created

formatdate-time
effective_date: string

Date when this policy becomes effective

formatdate
employer_id: string

ID of the employer this policy belongs to (empr_*)

name: string

Display name for the eligibility policy

rules: array of object { operator, rule_type, value }

List of eligibility rules that must be satisfied

operator: string

Comparison operator (e.g., 'equals', 'greater_than', 'in')

rule_type: string

Type of eligibility rule (e.g., 'employment_status', 'hours_per_week', 'waiting_period')

value: unknown

Value to compare against (type depends on rule_type)

updated_at: string

Timestamp when the policy was last updated

formatdate-time
description: optional string

Detailed description of the policy

replaced_policy_id: optional string

ID of the policy this one replaces, if any (epol_*)