Search
K
Policy

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

LoanAttributes

object
loanBalancestringrequired

Loan Balance

Example:10000

loanPrincipalstringrequired

Loan Principal

Example:8000

payoffBalancestringrequired

Payoff Balance

Example:7500

maximumAvailableLoanstringrequired

Maximum Available Loan

Example:20000

minimumLoanAmountstringrequired

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

lastLoanInterestAmountstringrequired

Last Loan Interest Amount

Example:200

loanInterestPaidToDatestringrequired

Loan Interest Paid To Date

Example:800

numberOfLoansstringrequired

Number of Loans

Example:2

loanInterestMethodstring

The Loan Interest Method defines when policy loan interest is paid—either in advance (upfront) or in arrears (at the end of the loan period). This method affects how and when interest is charged, calculated, and added to the total loan balance

Allowed values:SimpleCompound

Example:Simple

loanAmountSinceAnniversarystringrequired

Loan Amount Since Anniversary

Example:1500

minimumLoanPaymentAmountstringrequired

Minimum Loan Payment Amount

Example:500

loanRepaymentTypestring

The Loan Repayment Type refers to how loan repayments are applied to a policy loan—whether interest is paid first or the principal is reduced first. This affects how the loan balance decreases over time and the total interest paid by the policyholder

Allowed values:RecurringOne-time

Example:Recurring

Example

Loan

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