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

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

# WithdrawalAttributes

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    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
```