---
title: "PartialWithdrawalParty"
url: "https://developers.zinnia.com/apis/policy-transactions-1-0-2/versions/d0006570-ab9d-464e-814f-d120ba425e84/schemas/PartialWithdrawalParty"
---

> Full API specification: https://developers.zinnia.com/apis/policy-transactions-1-0-2/versions/d0006570-ab9d-464e-814f-d120ba425e84.md

# PartialWithdrawalParty

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia Policy Transactions API.
  version: 1.0.8
servers:
  - url: https://dev.api.zinnia.io
    description: DEV Environment
  - url: https://qa.api.zinnia.io
    description: QA Environment
components:
  schemas:
    PartialWithdrawalPartyRole:
      type: string
      enum:
        - OWNER
        - PRIMARYBENEFICIARY
        - CONTINGENTBENEFICIARY
        - INSURED
        - PAYOR
        - PAYEE
        - AGENT
        - CARRIER
        - THIRDPARTYDESIGNEE
        - THIRDPARTYADMINISTRATOR
        - JOINTOWNER
        - COVERAGEINSURED
        - COVERAGEJOINTINSURED
        - ASSIGNEE
        - PRIMARYWRITINGAGENT
        - PRIMARYSERVICINGAGENT
        - ADDITIONALSERVICINGAGENT
        - ADDITIONALWRITINGAGENT
        - ANNUITANT
        - EXCHANGECOMPANY
        - JOINTANNUITANT
        - GRANTOR
        - TRUSTEE
        - POWEROFATTORNEY
        - AUTHORIZEDSIGNATORY
        - OTHERINTERESTEDPARTY
        - CONTINGENTOWNER
        - SUCCESSORTRUSTEE
      example: OWNER
    PartialWithdrawalPartyType:
      type: string
      enum:
        - INDIVIDUAL
        - ORGANIZATION
      example: INDIVIDUAL
    PaymentForm:
      type: string
      enum:
        - DTCC
        - CREDITCARD
        - ACH
        - CHECK
        - WIRE
        - EXCHANGE
        - EFT
      description: Mode of payment
    PartialWithdrawalPreferredContactMethod:
      type: string
      enum:
        - MAIL
        - PHONE
        - EMAIL
      example: MAIL
    PartialWithdrawalPersonalInformation:
      type: object
      properties:
        prefix:
          $ref: "#/components/schemas/PartialWithdrawalNamePrefix"
        suffix:
          $ref: "#/components/schemas/PartialWithdrawalNameSuffix"
        firstName:
          type: string
          example: Jordan
        middleName:
          type: string
          nullable: true
        lastName:
          type: string
          example: Taylor
        fullName:
          type: string
          example: Jordan Taylor
        gender:
          $ref: "#/components/schemas/PartialWithdrawalGender"
        dateOfBirth:
          type: string
          format: date
          example: 1987-11-03
        birthCountry:
          type: string
          example: US
        citizenshipCountry:
          type: string
          example: US
        birthState:
          type: string
          example: CA
    PartialWithdrawalOrganisationDetails:
      type: object
      properties:
        fullName:
          type: string
          example: xyz
        organizationCode:
          type: string
          example: 76A
        entityType:
          $ref: "#/components/schemas/PartialWithdrawalEntityType"
        trustDate:
          type: string
          format: date
          nullable: true
        trustType:
          $ref: "#/components/schemas/PartialWithdrawalTrustType"
        trustTitle:
          type: string
          example: TrustTitle
    PartialWithdrawalPhone:
      type: object
      properties:
        startDate:
          type: string
          format: date
          example: 2023-01-01
        endDate:
          type: string
          format: date
          example: 2023-01-01
        phoneType:
          $ref: "#/components/schemas/PartialWithdrawalPhoneType"
        countryCode:
          type: string
          example: "9"
        areaCode:
          type: string
          example: "973"
        dialNumber:
          type: string
          example: "765789"
        extension:
          type: string
          nullable: true
        bestTime:
          type: string
          nullable: true
        timezone:
          type: string
          nullable: true
        isPreferred:
          type: boolean
          example: false
        phoneId:
          type: string
          example: "1"
    PartialWithdrawalEmail:
      type: object
      properties:
        startDate:
          type: string
          format: date
          example: 2023-01-01
        endDate:
          type: string
          format: date
          example: 2023-01-01
        emailType:
          $ref: "#/components/schemas/PartialWithdrawalEmailType"
        emailAddress:
          type: string
          format: email
          example: user@example.com
        isPreferred:
          type: boolean
          example: false
        emailId:
          type: string
          example: "1"
    PartialWithdrawalAddress:
      type: object
      properties:
        addressId:
          type: string
          example: 134535214eedf32412
        addressType:
          $ref: "#/components/schemas/PartialWithdrawalAddressType"
        line1:
          type: string
          example: 123 Main St
        line2:
          type: string
          example: Apt 5B
        line3:
          type: string
          nullable: true
        city:
          type: string
          example: San Francisco
        state:
          type: string
          example: CA
        postalCode:
          type: string
          example: "94105"
        postalCodeExtension:
          type: string
          example: "1234"
        country:
          type: string
          example: US
    PartialWithdrawalOvernightCheckInfo:
      type: object
      properties:
        accountType:
          $ref: "#/components/schemas/PartialWithdrawalOvernightAccountType"
        accountName:
          type: string
          example: Security Benefit
        accountNumber:
          type: string
          example: "11434552525"
    PartialWithdrawalIdentification:
      type: object
      properties:
        identificationType:
          $ref: "#/components/schemas/PartialWithdrawalIdentificationType"
        identificationValue:
          type: string
          example: 123-45-6789
        issueState:
          type: string
          example: CA
        issueCountry:
          type: string
          example: US
        expirationDate:
          type: string
          format: date
          example: 2035-12-31
    PartialWithdrawalBankDetails:
      type: object
      properties:
        bankId:
          type: string
          example: "1232423525"
        nameOnAccount:
          type: string
          example: Alex J Taylor
        accountStatus:
          $ref: "#/components/schemas/PartialWithdrawalBankAccountStatus"
        accountType:
          $ref: "#/components/schemas/PartialWithdrawalBankAccountType"
        accountNumber:
          type: string
          example: "000111222333"
        routingNumber:
          type: string
          example: "121000358"
        ibanNumber:
          type: string
          nullable: true
        financialInstitutionName:
          type: string
          example: Acme Bank
        branchName:
          type: string
          nullable: true
        bankAccountPurpose:
          $ref: "#/components/schemas/PartialWithdrawalBankAccountPurpose"
        address:
          $ref: "#/components/schemas/PartialWithdrawalAddress"
    PartialWithdrawalNamePrefix:
      type: string
      enum:
        - MR
        - MS
        - MISS
        - DR
        - MRS
      example: MR
    PartialWithdrawalNameSuffix:
      type: string
      enum:
        - JR
        - SR
        - I
        - II
        - III
        - IV
        - V
        - VI
        - VII
      example: JR
    PartialWithdrawalGender:
      type: string
      enum:
        - FEMALE
        - MALE
        - OTHER
      example: FEMALE
    PartialWithdrawalEntityType:
      type: string
      enum:
        - SOLEPROPRIETORSHIP
        - GENERALPARTNERSHIP
        - LIMITEDPARTNERSHIP
        - SCORPORATION
        - CCORPORATION
        - LIMITEDLIABILITYCOMPANY
        - CHARITABLEORGANIZATION
        - ESTATE
        - TRUST
        - CORPORATION
        - UNKNOWN
      example: CORPORATION
    PartialWithdrawalTrustType:
      type: string
      enum:
        - INDIVIDUALTRUST
        - CORPORATETRUST
        - TESTAMENTARYTRUST
        - INTERVIVOSTRUST
        - GRANTORTRUST
        - PETTRUST
      example: INDIVIDUALTRUST
    PartialWithdrawalPhoneType:
      type: string
      enum:
        - MOBILE
        - HOME
        - BUSINESS
        - CLAIMCENTER
        - CUSTOMERSERVICE
        - CORPORATEOFFICE
        - FAX
        - UNKNOWN
        - OTHER
      example: MOBILE
    PartialWithdrawalEmailType:
      type: string
      enum:
        - PERSONAL
        - BUSINESS
        - CUSTOMERSERVICE
        - OTHER
      example: PERSONAL
    PartialWithdrawalAddressType:
      type: string
      enum:
        - RESIDENCE
        - BUSINESS
        - POBOX
        - SEASONAL
        - SECONDARY
        - MAILING
      example: RESIDENCE
    PartialWithdrawalOvernightAccountType:
      type: string
      enum:
        - USPS
        - FEDEX
        - UPS
        - DHL
      example: USPS
    PartialWithdrawalIdentificationType:
      type: string
      enum:
        - SSN
        - EIN
        - TIN
        - DRIVERSLICENSE
        - PASSPORT
      example: SSN
    PartialWithdrawalBankAccountStatus:
      type: string
      enum:
        - ACTIVEBANKACCOUNT
        - TERMINATEDBANKACCOUNT
      example: ACTIVEBANKACCOUNT
    PartialWithdrawalBankAccountType:
      type: string
      enum:
        - CHECKING
        - SAVINGS
        - CREDITCARD
        - DEBITCARD
        - BROKERAGEACCOUNT
        - CERTIFICATEOFDEPOSIT
        - WIRE
      example: CHECKING
    PartialWithdrawalBankAccountPurpose:
      type: string
      enum:
        - LOANINTERESTBILLING
        - DISBURSEMENTS
        - LOANPRINCIPALBILLING
        - PREMIUMBILLING
        - ONETIMEPREMIUMBILLING
        - PAYOUT
        - ONETIMEWIRE
      example: DISBURSEMENTS
    PartialWithdrawalParty:
      type: object
      properties:
        partyId:
          type: string
          example: 134535214eedf32412
        addressId:
          type: string
          example: 134535214eedf32412
        bankId:
          type: string
          example: "1232423525"
        partyRole:
          $ref: "#/components/schemas/PartialWithdrawalPartyRole"
        partyType:
          $ref: "#/components/schemas/PartialWithdrawalPartyType"
        paymentForm:
          $ref: "#/components/schemas/PaymentForm"
        allocationPercentage:
          type: number
          format: double
          example: 100
        forBenefitOfOrForFurtherCredit:
          type: string
          example: ABCD
        relationshipToOwner:
          type: string
          example: string
        preferredContactMethod:
          $ref: "#/components/schemas/PartialWithdrawalPreferredContactMethod"
        personalInformation:
          $ref: "#/components/schemas/PartialWithdrawalPersonalInformation"
        organisationDetails:
          $ref: "#/components/schemas/PartialWithdrawalOrganisationDetails"
        phones:
          type: array
          items:
            $ref: "#/components/schemas/PartialWithdrawalPhone"
        emails:
          type: array
          items:
            $ref: "#/components/schemas/PartialWithdrawalEmail"
        addresses:
          type: array
          items:
            $ref: "#/components/schemas/PartialWithdrawalAddress"
        overnightCheckInfo:
          $ref: "#/components/schemas/PartialWithdrawalOvernightCheckInfo"
        identifications:
          type: array
          items:
            $ref: "#/components/schemas/PartialWithdrawalIdentification"
        bankDetails:
          $ref: "#/components/schemas/PartialWithdrawalBankDetails"
      required:
        - partyId
        - partyRole
        - paymentForm
        - allocationPercentage
```