Search
K
Policy

AccountValueAttributes

object
cashValueAmountstringrequired

Cash Value Amount

Example:1000

beginningAccountValuestringrequired

The Account Value refers to the total cash value of a life insurance policy or annuity at the beginning of each transaction, including both loaned and unloaned amounts. It represents the policy’s accumulated value before deductions, withdrawals, or new transactions

Example:2000

endingAccountValuestringrequired

The Current Account Value refers to the total cash value of a life insurance policy or annuity (including loaned and unloaned amounts) as of the last processed transaction. This value is used to determine the available account value (AV) for policyholders and is also the amount on which Fixed Interest is credited

Example:1500

minimumAccountValuestringrequired

Minimum Account Value

Example:500

cashValueByYearstringrequired

Cash Value By Year

Example:200

unLoanedAcctValuestringrequired

Unloaned Account Value

Example:300

loanedAcctValuestringrequired

Loaned Account Value

Example:100

cashSurrenderValuestringrequired

Cash Surrender Value

Example:800

netAmountAtRiskstringrequired

The Net Amount at Risk (NAR) is the difference between the policy’s total death benefit and the policy’s account value (cash value). It represents the portion of the death benefit that the insurance company is at risk of paying out beyond the policyholder’s accumulated account value

Example:50

deemedCashValueAmountstringrequired

Deemed Cash Value Amount

Example:400

Example

PolicyMetricsAttributes

object
initialPaymentAmountstringrequired

Initial Payment Amount

Example:5000

initialPremiumAppliedAmountstringrequired

The Initial Premium Applied Amount refers to the portion of the initial premium payment that is officially applied to the policy after processing. This amount determines when the policy becomes active and how funds are allocated within the contract

Example:4800

initialPaymentAmountReceivedDatestringrequired

The Initial Premium Amount Received Date refers to the date when the insurance company`s home office officially receives the first premium payment for a life insurance policy or annuity contract. This date is crucial as it determines when the policy processing begins and may impact policy activation timelines

Example:2021-01-01

grossPremiumAmountSinceIssuestringrequired

Gross Premium Amount Since Issue

Example:7500

totalCumulativePremiumAmountstringrequired

Total Cumulative Premium Amount

Example:20000

modifiedEndowmentContractAuthorizationIndicatorstring

MEC Authorization refers to the approval process required when a life insurance policy is classified as a Modified Endowment Contract (MEC). A MEC is a permanent life insurance policy that fails the IRS “7-Pay Test,” resulting in different tax treatment of policy loans and withdrawals. MEC Authorization is typically required from the policyholder before processing transactions that could convert the policy into a MEC, ensuring they understand the tax consequences

Allowed values:YESNO

Example:YES

projectedLapseIndicatorstring

The Projected Lapse Indicator is a forecast that indicates whether a life insurance policy is expected to lapse within the next policy year based on its current account value, premium payments, cost of insurance (COI), and other policy charges

Allowed values:YESNO

Example:YES

policyGainAmountstringrequired

The Policy Gain Amount is the difference between the policy’s total account value and the cost basis. It represents the amount of gain that may be subject to taxation if withdrawn or surrendered

Example:3000

Example

PolicyMetrics

object
attributesobjectrequired
Show Child Parameters
Example

WithdrawalAttributes

object
totalWithdrawalAmountSinceIssuestringrequired

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

Example:5000

freeWithdrawalAmountstringrequired

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

Example:1000

minimumWithdrawalAmountstringrequired

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:200

maximumWithdrawalAmountstringrequired

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:100

maximumWithdrawalAmountSinceAnniversarystringrequired

Example:10

numberWithdrawalDuringVestingPeriodstringrequired

Example:10

numberWithdrawalAfterVestingPeriodstringrequired

Example:10

cumulativeWithdrawalAmountSinceAnniversarystringrequired

Example:10

numberWithdrawalSinceIssuestringrequired

Example:10

withdrawalAllowedStartDatestringrequired

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:10

Example

Withdrawal

object
attributesobjectrequired
Show Child Parameters
Example