---
title: "AccountValue"
url: "https://developers.zinnia.com/apis/policy-service-0-1-0/versions/8306e031-b41c-452a-a7ed-d73d65602086/schemas/AccountValue"
---

> Full API specification: https://developers.zinnia.com/apis/policy-service-0-1-0/versions/8306e031-b41c-452a-a7ed-d73d65602086.md

# AccountValue

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    AccountValueAttributes:
      type: object
      properties:
        cashValueAmount:
          type: string
          example: "1000"
          description: Cash Value Amount
        beginningAccountValue:
          type: string
          example: "2000"
          description: 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
        endingAccountValue:
          type: string
          example: "1500"
          description: 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
        minimumAccountValue:
          type: string
          example: "500"
          description: Minimum Account Value
        cashValueByYear:
          type: string
          example: "200"
          description: Cash Value By Year
        unLoanedAcctValue:
          type: string
          example: "300"
          description: Unloaned Account Value
        loanedAcctValue:
          type: string
          example: "100"
          description: Loaned Account Value
        cashSurrenderValue:
          type: string
          example: "800"
          description: Cash Surrender Value
        netAmountAtRisk:
          type: string
          example: "50"
          description: 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
        deemedCashValueAmount:
          type: string
          example: "400"
          description: Deemed Cash Value Amount
      required:
        - cashValueAmount
        - beginningAccountValue
        - endingAccountValue
        - minimumAccountValue
        - cashValueByYear
        - unLoanedAcctValue
        - loanedAcctValue
        - cashSurrenderValue
        - netAmountAtRisk
        - deemedCashValueAmount
    PolicyMetrics:
      type: object
      properties:
        attributes:
          $ref: "#/components/schemas/PolicyMetricsAttributes"
      required:
        - attributes
    Loan:
      type: object
      properties:
        status:
          type: string
        principle:
          type: number
        interestPaid:
          type: number
        chargeRate:
          type: number
        creditRate:
          type: number
        balance:
          type: number
        maxAvailable:
          type: number
        loanIntDueAmt:
          type: number
        prefIntDueAmt:
          type: number
        loanFundValue:
          type: array
          items:
            $ref: "#/components/schemas/LoanFundValue"
    Withdrawal:
      type: object
      properties:
        attributes:
          $ref: "#/components/schemas/WithdrawalAttributes"
      required:
        - attributes
    PolicyMetricsAttributes:
      type: object
      properties:
        initialPaymentAmount:
          type: string
          example: "5000"
          description: Initial Payment Amount
        initialPremiumAppliedAmount:
          type: string
          example: "4800"
          description: 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
        initialPaymentAmountReceivedDate:
          type: string
          example: 2021-01-01
          description: 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
        grossPremiumAmountSinceIssue:
          type: string
          example: "7500"
          description: Gross Premium Amount Since Issue
        totalCumulativePremiumAmount:
          type: string
          example: "20000"
          description: Total Cumulative Premium Amount
        modifiedEndowmentContractAuthorizationIndicator:
          type: string
          example: YES
          enum:
            - YES
            - NO
          description: 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
        projectedLapseIndicator:
          type: string
          example: YES
          enum:
            - YES
            - NO
          description: 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
        policyGainAmount:
          type: string
          example: "3000"
          description: 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
      required:
        - initialPaymentAmount
        - initialPremiumAppliedAmount
        - initialPaymentAmountReceivedDate
        - grossPremiumAmountSinceIssue
        - totalCumulativePremiumAmount
        - policyGainAmount
    LoanFundValue:
      type: object
      properties:
        toTotValPct:
          type: number
        fundName:
          type: string
        fundNumber:
          type: string
        fundTypeCd:
          type: string
        interestRate:
          type: number
        fundValueAmt:
          type: number
    WithdrawalAttributes:
      type: object
      properties:
        totalWithdrawalAmountSinceIssue:
          type: string
          example: "5000"
          description: 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
        freeWithdrawalAmount:
          type: string
          example: "1000"
          description: 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
        minimumWithdrawalAmount:
          type: string
          example: "200"
          description: 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
        maximumWithdrawalAmount:
          type: string
          example: "100"
          description: 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
        maximumWithdrawalAmountSinceAnniversary:
          type: string
          example: "10"
        numberWithdrawalDuringVestingPeriod:
          type: string
          example: "10"
        numberWithdrawalAfterVestingPeriod:
          type: string
          example: "10"
        cumulativeWithdrawalAmountSinceAnniversary:
          type: string
          example: "10"
        numberWithdrawalSinceIssue:
          type: string
          example: "10"
        withdrawalAllowedStartDate:
          type: string
          description: 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"
      required:
        - totalWithdrawalAmountSinceIssue
        - freeWithdrawalAmount
        - minimumWithdrawalAmount
        - maximumWithdrawalAmount
        - maximumWithdrawalAmountSinceAnniversary
        - numberWithdrawalDuringVestingPeriod
        - numberWithdrawalAfterVestingPeriod
        - cumulativeWithdrawalAmountSinceAnniversary
        - numberWithdrawalSinceIssue
        - withdrawalAllowedStartDate
    AccountValue:
      type: object
      properties:
        attributes:
          $ref: "#/components/schemas/AccountValueAttributes"
        policyMetrics:
          $ref: "#/components/schemas/PolicyMetrics"
        loan:
          $ref: "#/components/schemas/Loan"
        withdrawal:
          $ref: "#/components/schemas/Withdrawal"
      required:
        - attributes
        - policyMetrics
        - loan
        - withdrawal
```