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

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

# ApplicationV3

## 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:
    Attachment:
      type: object
      additionalProperties: false
      properties:
        signatureMethod:
          type: string
          description: Method used to capture the customer’s signature (e.g., electronic,
            wet)
          enum:
            - NONE
            - VOICE
            - SIGNATUREPAD
            - WETSIGNATURESCANNED
            - BIOMETRIC
            - CLICKTHROUGH
        documentControlNumber:
          type: string
          description: documentControlNumber is an NSCC data point, Will be derived by
            Zinnia.
        totalAttachmentCount:
          type: string
          description: Total Attachment Count expected in Attachment payload
    ApplicationV3:
      type: object
      required:
        - appId
        - submissionType
        - carrierName
        - versionNumber
        - qualificationType
        - suitabilityAppIndicator
        - dateQualifiers
      properties:
        key:
          type: string
          description: Zinnia Unique idenitifer for a case. [Derived by Zinnia]
        appId:
          type: string
          description: Unique Identifier against an e-App application. First 4 letters
            represent the receiving company, next 3 letters represent the firm,
            next 8 positions represent the date eApp is submitted, next 10
            positions represents the sequential number of the eApps from the
            eApp instance.
        vendorAppId:
          type: string
          description: Application identifier assigned by an external vendor or partner
            system.
        versionNumber:
          type: string
          description: Version for that case - 3 digits, incremental if same case if
            submitted more than once in case of errors.
        qlacIndicator:
          type: string
          description: Flag indicating whether the contract is a Qualified Longevity
            Annuity Contract (QLAC).
          enum:
            - YES
            - NO
          example: YES
        ofacIndicator:
          type: string
          description: Indicator identifying whether the address is subject to OFAC review
            or screening.
          enum:
            - YES
            - NO
        fileInceptionTime:
          type: string
          format: date-time
          description: Time when the case is received within ETP
          example: 2025-06-26T00:00:00Z
        dateQualifiers:
          type: object
          required:
            - initialSubmitDate
            - agentSubmitDate
          properties:
            effectiveDate:
              type: string
              format: date
              description: e-App submitted date to Zinnia (with pattern "yyyy-mm-dd").
            applicationDate:
              type: string
              format: date
              description: Application date (with pattern "yyyy-mm-dd"). This field is
                required for paper app rate lock calculations.
            initialSubmitDate:
              type: string
              format: date
              description: Initial e-App submitted date (yyyy-mm-dd)
            applicationReceivedDate:
              type: string
              format: date
              description: Application received date (with pattern "yyyy-mm-dd"). Mandatory
                field for Paper Apps.
            clientAgreementDate:
              type: string
              format: date
              description: Client agreement date (with pattern "yyyy-mm-dd").
            agentSubmitDate:
              type: string
              format: date
              description: Agent submission date (yyyy-mm-dd)
            ownerSignedDate:
              type: string
              format: date
              description: Owner signed date (yyyy-mm-dd)
            jointOwnerSignedDate:
              type: string
              format: date
              description: Joint owner signed date (yyyy-mm-dd)
            annuitantSignedDate:
              type: string
              format: date
              description: Annuitant signed date (yyyy-mm-dd)
            jointAnnuitantSignedDate:
              type: string
              format: date
              description: Joint annuitant signed date (yyyy-mm-dd)
            trusteeSignedDate:
              type: string
              format: date
              description: Trustee signed date (yyyy-mm-dd)
            primaryAgentSignedDate:
              type: string
              format: date
              description: Primary agent signed date (yyyy-mm-dd)
            beneficiarySignedDate:
              type: string
              format: date
              description: Beneficiary signed date (yyyy-mm-dd)
            spouseSignedDate:
              type: string
              format: date
              description: Spouse signed date (yyyy-mm-dd)
        submissionType:
          type: string
          example: ELECTRONIC
          description: To determine whether the request is via eApp or Paper App
          enum:
            - ELECTRONIC
            - PAPER
        customerOtherProductsAnswer:
          type: string
          example: YES
          description: Indicates whether the applicant has existing life insurance or
            annuity policies. Valid values are Yes, No, or Unknown.
        applicationSignedCounty:
          type: string
          description: County where the application was signed by the customer.
        submitterNsccId:
          type: string
          description: The NSCC assigned membership ID for the firm initiating the
            transactions.Only applicable for DTCC cases.
        submitterNsccName:
          type: string
          description: Name of the Submitter (Settling Firm).Only applicable for DTCC cases.
        associatedFirmId:
          type: string
          description: Identifier assigned by a clearing firm/service provider to a firm
            that clears business through them.Only applicable for DTCC cases.
        associatedFirmName:
          type: string
          description: Name of associated firm.Only applicable for DTCC cases.
        vendorId:
          type: string
          description: An identifer that represents Transmitting Company which is of 4 char.
        vendorName:
          type: string
          description: Transmitting Company Name
          example: FIRELIGHT
        carrierName:
          type: string
          description: Name of the U.S. insurance company that is issuing the policy.
            [Derived by Zinnia]
        carrierId:
          type: number
          description: Carrier Id is DTCC part id for a given insurance carrier such as
            4527, 0015.
        firmTaxId:
          type: string
          description: 9 digit Tax ID in MCS [Zinnia Commission System] that belongs to
            the Firm. firmExternalId or firmTaxId or firmNPN is mandatory.
        firmNPN:
          type: string
          description: NPN in MCS [Zinnia Commission System] that belongs to the Firm.
            firmExternalId or firmTaxId or firmNPN is mandatory.
        firmExternalId:
          type: string
          description: External ID in MCS [Zinnia Commission System] that belongs to the
            Firm. firmExternalId or firmTaxId or firmNPN is mandatory.
        replacementIndicator:
          type: boolean
          description: Indicates whether the application is submitted as an exchange or
            replacement of an existing policy.
        qualificationType:
          type: string
          description: Indicator showing whether the application meets qualification
            requirements.
          enum:
            - Q401K
            - SOLO401K
            - HEALTHREIMBURSEMENT501C9
            - Q457B
            - HR10KEOGH
            - INHERITEDINDIVIDUALRETIREMENTACCOUNT
            - NONQUALIFIEDSTRETCH
            - INHERITEDROTHINDIVIDUALRETIREMENTACCOUNT
            - INDIVIDUALRETIREMENTACCOUNTREGULAR
            - INDIVIDUALRETIREMENTACCOUNTROLLOVER
            - NONQUALIFIED
            - PENSIONPLAN
            - SALARYREDUCTIONSIMPLIFIEDEMPLOYEEPENSION
            - SIMPLIFIEDEMPLOYEEPENSIONINDIVIDUALRETIREMENTACCOUNT
            - INDIVIDUALRETIREMENTACCOUNTSPOUSAL
            - INDIVIDUALRETIREMENTACCOUNTTRANSFER
            - CASHBALANCEPLANDEFINEDCONTRIBUTIONS
            - CASHBALANCEPLANDEFINEDBENEFIT
            - SOLODEFINEDBENEFIT
            - Q403B
            - Q401GFORMERLY403G
            - Q412IPLAN
            - INDIVIDUALRETIREMENTACCOUNTSIMPLE
            - ROTHINDIVIDUALRETIREMENTACCOUNT
            - ROTH401K
            - ROTH403B
            - EDUCATIONALINDIVIDUALRETIREMENTACCOUNT
            - PROFITSHARINGPLAN
            - MONEYPURCHASEPLAN
            - WELFAREBENEFITPLAN419PLAN
            - LONGTERMCARE7702B
            - NOUNITEDSTATESTAXATIONUSEDFOROFFSHOREPRODUCTS
            - Q401A
            - TEXASOPTIONALRETIREMENTPROGRAM
            - TARGETBENEFITPLAN
            - Q403BTRANSFERSONLY
            - ROTH457
            - CUSTODIALINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALROTHINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALROLLOVERINDIVIDUALRETIREMENTACCOUNT
            - CONVERTEDROTHINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALINHERITEDINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALINHERITEDROTHINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALSPOUSEINDIVIDUALRETIREMENTACCOUNT
            - CUSTODIALINDIVIDUALRETIREMENTACCOUNTSIMPLIFIEDEMPLOYEEPENSION
            - QUALIFIED
            - UNIFORMGIFTSORTRANSFERSTOMINORACT
            - CONVERTEDINDIVIDUALRETIREMENTACCOUNT
            - CORPORATEPENSION
            - GROUPTAXSHELTEREDANNUITY
            - CORPORATEDEFERREDCOMPENSATION404
            - QN457B
            - CONVERTED
            - SPOUSAL
            - CUSTODIAL
        custodial:
          type: string
          description: Flag indicating whether an application is associated with custodian
            or not.
          example: YES
          enum:
            - YES
            - NO
        commissionOption:
          type: string
          description: Commission option value provided by Zinnia for the applicable
            product. This value is used to determine agent commissions.
        brokerageIdentificationNumber:
          type: string
          description: Client account identifier used by the distributor.
        suitabilityAppIndicator:
          type: string
          example: YES
          description: Indicator that a suitability review is required or has been
            performed.
          enum:
            - YES
            - NO
        attachment:
          type: array
          items:
            $ref: "#/components/schemas/Attachment"
```