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

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

# InitialPremiumRequest

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    InitialPremiumRequestTransactionAmounts:
      type: object
      properties:
        requestedAmount:
          type: number
          example: 1000.31
          description: Requested amount value
          format: double
        netPaymentAmount:
          type: number
          example: 48000.52
          description: The net amount actually received from the agent to be applied to
            the policy
          format: double
    FundAllocationAllocationOption:
      type: object
      properties:
        allocationOption:
          $ref: "#/components/schemas/AllocationOption"
    TransactionExchange:
      type: object
      properties:
        exchangeId:
          type: string
          description: Exchange ID is a unique identifier assigned to a policy or
            transaction involved in an exchange or rollover process. It is used
            to track, reference, and reconcile activities related to the
            replacement, transfer, or conversion of funds or policies between
            contracts, products, or carriers.
          example: EX0000001
        policyNumber:
          type: string
          description: The original policy number involved in an exchange or replacement
            transaction.
          example: POLICY1234567890
        exchangeDescription:
          type: string
          enum:
            - DEFAULT
            - EXTERNAL1035
            - INTERNAL1035
            - EXTERNALDIRECTTRANSFER
            - INTERNALDIRECTTRANSFER
            - EXTERNALROLLOVERQUALIFIED
            - INTERNALROLLOVERQUALIFIED
            - EXTERNALROTHROLLOVER
            - INTERNALROTHROLLOVER
            - EXTERNALROTHDIRECTTRANSFER
            - INTERNALROTHDIRECTTRANSFER
            - BENEFITPROCEEDS
            - CASHCONTRIBUTIONS
            - EXTERNAL1035PARTIAL
            - INTERNAL1035PARTIAL
            - BIRTHORADOPTIONREPAYMENT
            - INTERNALDIRECTTRANSFERREPLACEMENT
            - EXTERNALDIRECTTRANSFERREPLACEMENT
            - CLIENTINITIATEDTRANSFER
            - CONVERSION
          description: Description of the type of exchange such as External 1035, Internal
            1035, etc
        exchangeDate:
          type: string
          format: date
          description: The date on which 1035 Exchange occurs
          example: 2023-01-01
        lineOfBusiness:
          $ref: "#/components/schemas/LineOfBusiness"
        exchangeAmount:
          type: number
          format: double
          description: "Amount received in 1035 Exchange "
          example: 161.81698
        qualificationType:
          type: string
          enum:
            - INDIVIDUALRETIREMENTACCOUNTREGULAR
            - INDIVIDUALRETIREMENTACCOUNTSPOUSAL
            - INDIVIDUALRETIREMENTACCOUNTROLLOVER
            - ROTHINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALROTHINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALROLLOVERINDIVIDUALRETIREMENTACCOUNT
            - QUALIFIED
            - NONQUALIFIED
            - SIMPLIFIEDEMPLOYEEPENSIONINDIVIDUALRETIREMENTACCOUNT
            - INHERITEDINDIVIDUALRETIREMENTACCOUNT
            - INHERITEDROTHINDIVIDUALRETIREMENTACCOUNT
            - NONQUALIFIEDSTRETCH
            - INDIVIDUALRETIREMENTACCOUNTSIMPLE
            - Q403B
            - Q401K
            - Q401A
            - Q457B
            - PENSIONPLAN
            - CONVERTEDINDIVIDUALRETIREMENTACCOUNT
            - ROTH403B
            - CUSTODIALINDIVIDUALRETIREMENTACCOUNTSIMPLIFIEDEMPLOYEEPENSION
            - KEOGH10
            - CORPORATEPENSION
            - GROUPTAXSHELTEREDANNUITY
            - PROFITSHARING
            - TARGETBENEFIT
            - CORPORATEDEFERREDCOMPENSATION404
            - EDUCATIONALINDIVIDUALRETIREMENTACCOUNT
            - QN457B
            - CONVERTED
            - SPOUSAL
            - CUSTODIAL
            - UNIFORMGIFTSORTRANSFERSTOMINORACT
            - CUSTODIALQUALIFIEDLONGEVITYANNUITYCONTRACTINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALSIMPLEINDIVIDUALRETIREMENTACCOUNT
            - MONEYPURCHASEPENSIONPLAN
            - Q401G
            - Q412E3
            - QUALIFIEDLONGEVITYANNUITYCONTRACTINDIVIDUALRETIREMENTACCOUNT
            - ROTH401K
            - VARIABLEUNIVERSALLIFENONQUALIFIED
          description: Qualification type of original policy being exchanged
        costBasis:
          type: number
          format: double
          description: Original cost basis of the policy being exchanged - previous Policy
          example: 161.81698
        modifiedEndowmentContractStatus:
          type: boolean
          description: Indicates if the original policy being exchanged is classified as MEC
        outstandingLoanRolloverAmount:
          type: number
          format: double
          description: The amount of any outstanding loan against the original policy that
            will be rolled over into the new policy during the 1035 exchange
          example: 161.81698
      required:
        - policyNumber
    TransactionTaxBasis:
      type: object
      properties:
        currentContributionAmount:
          type: number
          example: 161.81698
          format: double
          description: The contribution amount made toward the policy in the current tax
            year.
        currentTaxYear:
          type: number
          format: int32
          example: 1
          description: The tax year for which contributions are being recorded.
        priorContributionAmount:
          type: number
          format: double
          example: 161.81698
          description: The amount contributed in the previous tax year
        priorTaxYear:
          type: number
          format: int32
          example: 1
          description: The tax year associated with the prior contribution amount
        preTaxEquityAndFiscalResponsibilityActBasis:
          type: number
          format: double
          example: 161.81698
          description: The cost basis of the policy before the Tax Equity and Fiscal
            Responsibility Act (TEFRA) changes
        postTaxEquityAndFiscalResponsibilityActBasis:
          type: number
          format: double
          example: 161.81698
          description: The cost basis of the policy after Tax Equity and Fiscal
            Responsibility Act (TEFRA) changes
        postTechnicalAndMiscellaneousRevenueActAmount:
          type: number
          format: double
          example: 161.81698
          description: Deprecated - kept for backward compatibility. Applies to 403b Qual
            type
    InitialPremiumRequestPayor:
      type: object
      properties:
        partyId:
          type: string
          example: Party_PI_1
          description: Impacted Party in the event of financial transaction
        paymentForm:
          $ref: "#/components/schemas/PaymentForm"
        bankId:
          type: string
          example: Bank_1
          description: Comes in Acord 103
    AdhocDisbursementParty:
      type: object
      properties:
        partyRole:
          $ref: "#/components/schemas/PartyRole"
        partyId:
          type: string
          description: unique identifier linking the party to the policy
          example: Party_PI_1
        paymentForm:
          $ref: "#/components/schemas/PaymentForm"
        allocationPercentage:
          type: number
          description: The percentage of the total disbursement allocated to the payee
          example: 100
          format: double
        bankId:
          type: string
          description: A unique identifier for the financial institution handling the
            transaction
          example: Bank_1
        addressId:
          type: string
          description: A unique identifier for the address associated with the payee or
            policyholder
          example: "1"
        forBenefitOfOrForFurtherCredit:
          type: string
          description: FBO - For Benefit Of, FFC - For Further Credit. (To notate a second
            beneficiary or to designate a person or organization when funds are
            disbursed out)
          example: John Doe
        forBenefitOfOrForFurtherCreditIndicator:
          type: boolean
          example: true
          description: Indicates whether the outgoing funds are being requested for the
            benefit of or for further credit to another person or organization.
    AdhocExternalIdentifiers:
      type: object
      properties:
        referenceNumber:
          type: string
          description: The unique payment reference number for all premium-related
        externalTransactionId:
          type: string
          description: The unique ID to identify transaction on carrier side
    AllocationOption:
      type: string
      enum:
        - PRORATA
        - DOLLAR
        - SPECIFYPERCENTAGE
        - SPECIFIEDFUNDS
        - SPECIFIEDSEGMENTS
        - DEFAULT
        - PECKINGORDER
        - EARNINGSONLY
        - SPECIFICFUNDPERCENTAGE
        - FIXEDONLY
        - VARIABLEONLY
        - CURRENTHOLDINGS
    LineOfBusiness:
      type: string
      enum:
        - LIFE
        - ANNUITY
        - MUTUALFUND
        - CERTIFICATEOFDEPOSIT
        - BROKERAGE
        - OTHER
    PaymentForm:
      type: string
      enum:
        - DTCC
        - CREDITCARD
        - ACH
        - CHECK
        - WIRE
        - EXCHANGE
        - PREMIUMLOAN
    PartyRole:
      type: string
      enum:
        - OWNER
        - PRIMARYBENEFICIARY
        - CONTINGENTBENEFICIARY
        - INSURED
        - PAYOR
        - PAYEE
        - AGENT
        - PRIMARYWRITINGAGENT
        - PRIMARYSERVICINGAGENT
        - ADDITIONALSERVICINGAGENT
        - ADDITIONALWRITINGAGENT
        - THIRDPARTYDESIGNEE
        - JOINTOWNER
        - COVERAGEINSURED
        - ASSIGNEE
        - ANNUITANT
        - EXCHANGECOMPANY
        - JOINTANNUITANT
        - GRANTOR
        - TRUSTEE
        - POWEROFATTORNEY
        - AUTHORIZEDSIGNATORY
        - OTHERINTERESTEDPARTY
        - CONTINGENTOWNER
        - THIRDPARTYADMINISTRATOR
        - CARRIER
        - SUCCESSORTRUSTEE
        - COVERAGEJOINTINSURED
    InitialPremiumRequest:
      type: object
      properties:
        correlationId:
          type: string
          example: 864e43a0-2c2f-4a11-9d7f-69ed40115066
          description: The unique ID to track transaction request across all systems
        effectiveDate:
          type: string
          format: date
          example: 2023-01-01
          description: Date when the transaction was originally scheduled or expected to
            happen. It can be a non-business day
        reverseInitiator:
          type: boolean
          description: Property to isolate source transaction(s) that initiated the reversal
        transactionReason:
          type: string
          enum:
            - ONETIMEPREMIUM
            - GRACEPERIODPREMIUM
            - REINSTATEMENTPREMIUM
            - EXCHANGE1035
            - SURRENDER
            - AMOUNTEXCESSTOMEC
            - AMOUNTEXCESSTOGUIDELINE
            - CURRENTVALUE
            - COSTBASIS
            - GUIDELINESINGLEPREMIUM
            - GUIDELINELEVELPREMIUM
            - SEVENPAYPREMIUM
            - TOTALYTDPREMIUMAMOUNT
            - FACEDECREASECOVERAGE
            - FACEINCREASECOVERAGE
            - MECAUTHORIZATION
            - INITIALPREMIUMEXPIRATION
            - COMPLIANCE
            - STARTINGPRICE
            - LUMPSUM
            - FIVEYEARDEFERRAL
            - SPOUSALCONTINUATION
            - DISCOUNT
            - CONTROLBUSINESSINDICATOR
            - NATIONALCHANGEOFADDRESS
            - DATEOFDEATH
            - INITIALDEATHNOTIFICATION
            - PRODUCTDEFAULT
            - GWBRIDERDISBURSEMENT
            - GWBPHASECHANGE
            - PREMIUMLOAN
            - PAYMENTDUEDATE
          description: The justification or business reason for the transaction
        transactionAmounts:
          $ref: "#/components/schemas/InitialPremiumRequestTransactionAmounts"
        fundAllocation:
          $ref: "#/components/schemas/FundAllocationAllocationOption"
        exchange:
          $ref: "#/components/schemas/TransactionExchange"
        taxBasis:
          $ref: "#/components/schemas/TransactionTaxBasis"
        payor:
          $ref: "#/components/schemas/InitialPremiumRequestPayor"
        parties:
          type: array
          items:
            $ref: "#/components/schemas/AdhocDisbursementParty"
        externalIdentifiers:
          $ref: "#/components/schemas/AdhocExternalIdentifiers"
```