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

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

# SpecialPrograms

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business Annuity API
  version: 0.6.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:
    Funds:
      type: object
      required:
        - accCode
        - amountType
        - amount
      properties:
        accCode:
          type: string
          description: Zinnia will provide specific account code for individual funds per
            Product
        amountType:
          type: string
          description: Type of the Amount
          enum:
            - P
            - D
        amount:
          type: string
          format: 9(01) V9(09) for percentage and 9(14) V9(02) for Dollars
    BankInfo:
      type: object
      required:
        - bankName
        - abaNumber
        - accountNumber
        - bankingType
      properties:
        bankName:
          type: string
          description: Bank name
        abaNumber:
          type: string
          description: ABA number
        accountNumber:
          type: string
          description: Account Number
        bankingType:
          type: string
    SpecialPrograms:
      type: object
      required:
        - specialProgramType
        - startDate
        - mode
        - amountType
        - amount
        - duration
        - funds
        - firstPaymentDate
      properties:
        specialProgramType:
          type: string
          description: specialProgramType selected
          enum:
            - "0"
            - "1"
            - "2"
            - "3"
            - "4"
            - "5"
            - "6"
            - "8"
            - "9"
            - "10"
          example: "0"
        startDate:
          type: string
          format: date
          description: Effective date of Special program
        mode:
          type: string
          enum:
            - A
            - M
            - Q
            - S
            - W
            - "2"
            - "4"
            - T
            - "9"
            - "10"
          description: Frequency of special program
        amountType:
          type: string
          enum:
            - "-1"
            - "0"
            - "1"
            - "2"
            - "3"
            - "4"
            - "5"
            - "6"
            - "7"
            - "8"
            - "9"
            - "10"
            - "11"
            - "12"
            - "13"
            - "14"
            - "15"
            - "16"
            - "17"
            - "18"
            - "19"
            - "20"
            - "21"
            - "22"
            - "23"
            - "24"
            - "25"
            - "26"
            - "27"
            - "28"
            - "29"
            - "30"
            - "31"
            - "32"
            - "33"
            - "34"
            - "35"
            - "36"
            - "37"
            - "38"
            - "39"
            - "40"
            - "41"
            - "42"
            - "43"
            - "44"
            - "45"
            - "46"
            - "47"
            - "48"
            - "49"
            - "50"
            - "51"
            - "52"
            - "53"
            - "54"
            - "55"
            - "56"
          description: amountType of special program
        amount:
          type: string
          description: Stores the allocated percent to the specific fund
        distribCode:
          type: string
          enum:
            - "1"
            - "2"
            - "3"
            - "4"
            - "5"
            - "6"
            - "7"
            - "8"
            - "9"
            - A
            - D
            - E
            - F
            - G
            - H
            - J
            - L
            - M
            - P
            - R
            - S
            - AA
            - AB
            - AC
            - 2G
            - 4G
            - 4H
            - AD
            - AE
            - AF
            - AG
            - AH
            - AK
            - T
            - N
            - ZA
            - ZB
            - ZC
            - ZD
            - ZE
            - ZF
            - ZG
            - ZH
            - ZI
            - ZJ
            - ZK
            - ZL
            - ZM
            - ZN
            - ZO
            - ZP
            - ZQ
            - ZR
            - ZS
            - ZT
            - ZV
            - ZU
            - 6A
            - AL
            - AM
            - W
          description: Distribution Code
        duration:
          type: string
          description: Specifies how many times special program will be run
          example: "5"
        funds:
          type: array
          items:
            $ref: "#/components/schemas/Funds"
        bankInformation:
          $ref: "#/components/schemas/BankInfo"
        moneySrcId:
          format: int32
          type: string
          enum:
            - "0"
            - "1"
            - "2"
            - "3"
            - "4"
            - "5"
            - "6"
            - "7"
            - "8"
            - "9"
        firstPaymentDate:
          type: string
          format: date
        firstPaymentYear:
          type: string
        calculation:
          type: string
          description: Derived by Zinnia
        grossDisbursement:
          type: string
        waiveCharges:
          type: string
        nextDate:
          type: string
          description: Derived by Zinnia
        priorRMDAmtType:
          type: string
        priorRMDAmt:
          format: double
          type: number
```