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

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

# PartialWithdrawalTaxWithholdingInstruction

## 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:
    TaxWithholdingType:
      type: string
      enum:
        - FEDERAL
        - STATE
        - NRA
        - BACKUP
    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
    TaxRateToUse:
      type: string
      enum:
        - NOWITHHOLDINGELECTED
        - USEVALUESENTERED
        - NOWITHHOLDINGALLOWED
        - USEDEFAULTTABLE
        - ADDITIONALWITHHOLDING
      description: How tax rate should be applied for withholding
    PartialWithdrawalFilingStatus:
      type: string
      enum:
        - SINGLE
        - MARRIED
        - DEFAULT
        - DOMESTICPARTNER
        - DOMESTICPARTNERSHIP
        - HEADOFHOUSEHOLD
        - MARRIEDFILINGSEPARATELY
        - WIDOWED
        - DIVORCED
      description: Filing status for partial withdrawal tax withholding
      example: MARRIED
    PartialWithdrawalW4rContribution:
      type: string
      enum:
        - NOTAPPLICABLE
      example: NOTAPPLICABLE
    PartialWithdrawalW4r:
      type: object
      properties:
        filingStatus:
          $ref: "#/components/schemas/PartialWithdrawalFilingStatus"
        dollar:
          type: number
          format: double
          example: 0
        percentage:
          type: number
          format: double
          example: 0
        exemptions:
          type: number
          format: int32
          example: 0
    PartialWithdrawalTaxFormType:
      type: string
      enum:
        - T1035COSTBASIS
      example: T1035COSTBASIS
    PartialWithdrawalTaxWithholdingInstruction:
      type: object
      properties:
        partyId:
          type: string
          example: "2314134"
          description: Impacted party for tax withholding
        taxWithholdingType:
          $ref: "#/components/schemas/TaxWithholdingType"
        partyRole:
          $ref: "#/components/schemas/PartialWithdrawalPartyRole"
        taxRateToUse:
          $ref: "#/components/schemas/TaxRateToUse"
        filingStatus:
          $ref: "#/components/schemas/PartialWithdrawalFilingStatus"
        dollar:
          type: number
          format: double
          example: 0
        percentage:
          type: number
          format: double
          example: 0
        exemptions:
          type: number
          format: int32
          example: 0
        taxJurisdiction:
          type: string
          example: string
        contribution:
          $ref: "#/components/schemas/PartialWithdrawalW4rContribution"
        w4r:
          $ref: "#/components/schemas/PartialWithdrawalW4r"
        taxFormType:
          $ref: "#/components/schemas/PartialWithdrawalTaxFormType"
      required:
        - partyId
        - taxWithholdingType
```