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

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

# OneTimePremiumRequest

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    OneTimePremiumTransactionAmounts:
      type: object
      properties:
        requestedAmount:
          type: number
          example: 1000.32
          description: Requested amount value
          format: double
        appliedAmount:
          type: number
          example: 1000.43
          format: double
          description: The portion of the requested loan amount that was actually applied
            on the policy
        netPaymentAmount:
          type: number
          example: 48000.21
          format: double
          description: The net amount actually received from the agent to be applied to
            the policy
        imageNumber:
          type: string
          description: Internal identifier to track document number.
          example: IMG12345
    TransactionReason:
      type: string
      description: The specific reason or purpose for the transaction being processed
      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
    OneTimePremiumPayor:
      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.
    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
    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
    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
    LineOfBusiness:
      type: string
      enum:
        - LIFE
        - ANNUITY
        - MUTUALFUND
        - CERTIFICATEOFDEPOSIT
        - BROKERAGE
        - OTHER
    OneTimePremiumRequest:
      type: object
      properties:
        correlationId:
          type: string
          example: 657b717b7dcf554abf9ef067
          description: The unique ID to track transaction request across all systems
        effectiveDate:
          type: string
          example: 2023-01-01
          description: Date when the transaction was originally scheduled or expected to
            happen. It can be a non-business day
          format: date
        reverseInitiator:
          type: boolean
          example: false
          default: false
          description: Property to isolate source transaction(s) that initiated the reversal
        transactionAmounts:
          $ref: "#/components/schemas/OneTimePremiumTransactionAmounts"
        transactionReason:
          $ref: "#/components/schemas/TransactionReason"
        payor:
          $ref: "#/components/schemas/OneTimePremiumPayor"
        parties:
          type: array
          items:
            $ref: "#/components/schemas/AdhocDisbursementParty"
        exchange:
          $ref: "#/components/schemas/TransactionExchange"
        externalIdentifiers:
          $ref: "#/components/schemas/AdhocExternalIdentifiers"
```