---
title: "PayoutV3"
url: "https://developers.zinnia.com/apis/new-business-annuity/versions/45a989ab-c3aa-4f85-8f67-f05c41747ed7/schemas/PayoutV3"
---

> Full API specification: https://developers.zinnia.com/apis/new-business-annuity/versions/45a989ab-c3aa-4f85-8f67-f05c41747ed7.md

# PayoutV3

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business Annuity API
  version: 0.7.0
servers:
  - url: https://qa.api.zinnia.io
    description: QA Environment
  - url: https://dev.api.zinnia.io
    description: DEV Environment
  - url: https://uat.api.zinnia.io
    description: UAT Environment
  - url: https://api.zinnia.io
    description: PROD Environment
components:
  schemas:
    PayoutV3:
      type: object
      additionalProperties: false
      required:
        - payoutOption
      properties:
        payoutOption:
          type: string
          description: Payout option selected for annuity distributions.
          enum:
            - PERIODCERTAIN
            - LIFEONLY
            - LIFEWITHPERIODCERTAIN
            - LIFEWITHINSTALLMENTREFUND
            - LIFEWITHCASHREFUND
            - LESSOROFPERIODCERTAINORLIFE
            - LIFEWITHRETURNOFPREMIUM
            - AMOUNTCERTAIN
            - JOINTLIFEONLY
            - JOINTANDSURVIVOR
        livesType:
          type: string
          description: Indicates whether the payout is based on a single life or joint
            lives.
        primarySurvivorAdjType:
          type: string
          description: Type of adjustment applied to payments upon the primary annuitant’s
            death.
        primarySurvivorAdjPct:
          type: string
          description: Percentage of the original payment payable to the survivor after
            the primary annuitant’s death.
        jointSurvivorAdjType:
          type: string
          description: Type of adjustment applied to payments for a joint survivor.
        jointSurvivorAdjPct:
          type: string
          description: Percentage of the original payment payable to the joint survivor.
        annuityFrequencyCode:
          type: string
          description: Frequency at which annuity payments are made.
          enum:
            - EVERYTWOWEEKS
            - MONTHLY
            - BIMONTHLY
            - ANNUAL
            - SINGLEPAYMENT
            - QUARTERLY
            - SEMIANNUAL
        certainPeriodQualifier:
          type: string
          description: Qualifier indicating the unit of measure for the certain period
            (e.g., years or months).
          enum:
            - ANNUAL
            - BIMONTHLY
            - EVERYTWOWEEKS
            - SINGLEPAYMENT
            - MONTHLY
            - SEMIANNUAL
            - QUARTERLY
        certainPeriod:
          type: string
          description: Length of the guaranteed certain period associated with the payout
            option.
        payoutStartDate:
          type: string
          description: Date on which annuity payout payments begin.
          format: date
        fixedPaymentAmount:
          type: string
          description: Fixed payment amount payable for each annuity distribution.
          format: double
          example: "238500.50"
```