Search
K
Policy

LoanRepaymentType

string

Allowed values:INTERESTFIRSTPRINCIPALFIRST

LoanValues

object
totalLoanBalancenumber(double)

The Total Loan Balance refers to the outstanding loan amount on a life insurance policy, including the principal, accrued interest, and any unpaid loan charges. This balance reflects the total amount the policyholder owes the insurance company when a policy loan is taken against the cash value.

Example:1000

totalLoanPrincipalnumber(double)

The Total Loan Principal refers to the original amount borrowed by the policyholder against the cash value of a life insurance policy, excluding any accrued interest or unpaid loan charges. It represents the base loan amount before interest accumulation

Example:100

loanPayoffAmountnumber(double)

The Loan Payoff Amount refers to the total amount required to fully repay a policy loan, including the outstanding loan balance, accrued loan interest, and any adjustments for unearned interest. This value is calculated daily and fluctuates based on the loan’s interest accrual

Example:100

maximumLoanAmountnumber(double)

The Maximum Loan Amount refers to the highest amount a policyholder can borrow against their life insurance policy’s cash value. This limit is determined by the policy’s cash value, outstanding loans, and insurer-specific rules

Example:161.81698

minimumLoanAmountnumber(double)

The Minimum Loan Amount refers to the smallest amount a policyholder can borrow against their life insurance policy’s cash value, as defined by the insurer. This limit ensures that administrative costs and processing fees are justified for each loan transaction

Example:100

totalLoanAccruedInterestnumber(double)

The Total Loan Accrued Interest refers to the amount of interest that has accumulated on a policy loan so far within the current year. This interest is added to the outstanding loan balance if it is not paid separately by the policyholder

Example:100

lastLoanInterestDueDatestring(date)

The Last Loan Interest Due Date refers to the last policy anniversary date when loan interest was due on an outstanding policy loan. Since loan interest on life insurance policies is typically charged annually, this date always corresponds to the most recent policy anniversary date

Example:2023-01-01

totalNumberOfLoannumber(int32)

The Total Number of Loans refers to the total count of policy loans taken by the policyholder throughout the life of the insurance policy. It tracks each separate loan transaction, regardless of whether previous loans were repaid or still outstanding

Example:10

loanInterestMethodstring

Allowed values:ADVANCEARREARS

totalYearToDateLoanTakennumber(double)

The Total YTD (Year-To-Date) Loan Taken refers to the total amount of policy loans taken by the policyholder within the current calendar or policy year. It tracks all loan transactions processed within the year, excluding prior years` loan activity

Example:1000

loanRepaymentTypestring

Allowed values:INTERESTFIRSTPRINCIPALFIRST

minimumLoanRepaymentnumber(double)

The Minimum Loan Repayment refers to the smallest amount a policyholder is required to repay on a policy loan, as specified by the insurance company. This ensures that the loan balance is managed and prevents excessive interest accrual, which could lead to policy lapse

Example:100

Example

WithdrawalValues

object
totalWithdrawalAmountnumber(double)

The Total Withdrawal Amount refers to the cumulative amount of funds withdrawn from a life insurance policy or annuity by the policyholder. This includes all withdrawals made since the policy’s inception, whether taken as partial surrenders, cash value withdrawals, or systematic distributions

freeWithdrawalAmountnumber(double)

The Free Withdrawal Amount refers to the maximum amount a policyholder can withdraw from their life insurance policy or annuity in a contract year without incurring a surrender charge. This limit is set by the insurer and is typically expressed as a percentage of the account value or premiums paid

yearToDateFreeWithdrawalAmountnumber(double)required

The YTD Free Amount (Year-To-Date Free Withdrawal Amount) refers to the total amount withdrawn so far in the current contract year that was within the free withdrawal limit, meaning it did not incur surrender charges. This tracks how much of the allowable free withdrawal limit has been used

minimumWithdrawalAmountnumber(double)

The Minimum Withdrawal Amount refers to the smallest amount a policyholder can withdraw from their life insurance policy or annuity in a single transaction, as defined by the insurer. This ensures that withdrawals remain administratively efficient and align with policy rules

Example:1

maximumWithdrawalAmountnumber(double)

The Maximum Withdrawal Amount refers to the highest amount a policyholder can withdraw from their life insurance policy or annuity in a single transaction or within a policy year, as set by the insurer. This ensures that withdrawals do not deplete the policy’s cash value too quickly or violate contract terms

Example:161.81698

annualWithdrawalLimitNoCoverageDecreasenumber(double)

The Annual Withdrawal Limit for No Coverage Decrease refers to the maximum amount a policyholder can withdraw from their life insurance policy within a policy year without reducing the death benefit or coverage amount. This ensures that policyholders can access cash value while maintaining full coverage

Example:322.678939

maximumWithdrawalRequestDuringVestingPeriodnumber(int32)

The Max Withdrawal Request Allowed During Vesting Period refers to the highest number of withdrawal transactions permitted within the vesting period of a life insurance policy or annuity. This ensures policyholders follow contract rules while maintaining eligibility for vested benefits

Example:1

yearToDateNumberOfWithdrawalnumber(int32)

The YTD (Year-To-Date) Number of Withdrawals refers to the total count of withdrawal transactions made by the policyholder from the beginning of the policy year to the present date. This tracks how frequently funds have been withdrawn within the current policy year

Example:1

maximumWithdrawalRequestAfterVestingPeriodnumber(int32)

The Max Withdrawal Request Allowed After Vesting Period refers to the highest number of withdrawals a policyholder can make per year or over the life of the policy after the vesting period has ended. This ensures that policyholders can access their funds while still maintaining policy sustainability and compliance with contract terms

Example:12

totalYearToDateWithdrawalTakennumber(double)

The Total YTD (Year-To-Date) Withdrawal Taken refers to the total amount withdrawn by the policyholder from their life insurance policy or annuity within the current contract year. This tracks all withdrawals made so far from the beginning of the policy year up to the present date.

numberOfWithdrawalnumber(int32)

The Number of Withdrawals refers to the total count of withdrawal transactions made by the policyholder within a specified period, typically within the current policy year or calendar year. This tracks how frequently funds have been withdrawn from the policy

withdrawalAllowedStartDatestring(date)

The Withdrawal Allowed Start Date refers to the calculated date from which the policyholder is permitted to make withdrawals from the policy’s cash value or annuity funds. This date is determined based on policy terms, surrender charge periods, and regulatory restrictions

Example:2023-01-01

Example

MarketValueAdjustment

object
marketValueAdjustmentIndicatornumber

The MVA Indicator is a flag or marker that indicates whether a Market Value Adjustment (MVA) applies to an annuity or investment. This adjustment impacts the contract value when withdrawals or surrenders occur before the end of the contract’s term

Allowed values:true

marketValueAdjustmentAmountnumber(double)

The MVA Adjustment refers to the Market Value Adjustment applied to an annuity contract when a withdrawal or surrender occurs before the end of the contract period. It adjusts the contract value based on changes in interest rates since the contract was issued.

Example:12.42342

marketValueAdjustmentPeriodnumber(int32)

MVA Period (Market Value Adjustment Period) refers to the specific timeframe during which a Market Value Adjustment (MVA) may be applied to withdrawals, surrenders, or transfers from a fixed or indexed annuity contract. This period typically aligns with the guaranteed interest rate period and is designed to account for interest rate fluctuations that affect the insurer’s investment value

Example:1

marketValueAdjustmentBaseRatenumber(double)

The MVA Indicator is a flag or marker that indicates whether a Market Value Adjustment (MVA) applies to an annuity or investment. This adjustment impacts the contract value when withdrawals or surrenders occur before the end of the contract’s term.

Example:12.42342

Example

RequiredMinimumDistributionCalculationOption

string

Allowed values:RULE2002BENEFICIARYDISTRIBUTIONQUALIFIEDBENEFICIARYDISTRIBUTIONNONQUALIFIED