---
title: "PartyOwners"
url: "https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e/schemas/PartyOwners"
---

> Full API specification: https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e.md

# PartyOwners

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business API.
  version: 0.9.8
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:
    PartyOwners:
      type: object
      properties:
        firstName:
          type: string
          description: First Name of the party
          example: Thomas
        lastName:
          type: string
          description: Last Name of the the party
          example: Lawrence
        middleName:
          type: string
          description: Middle name of the party
        name:
          type: string
          description: Full name of the party.
          example: Thomas Lawrence
        suffix:
          type: string
          description: Suffix for given party if Applicable
          example: Sr
        prefix:
          type: string
          description: Prefix for given party if Applicable
          example: Dr
        gender:
          type: string
          enum:
            - Male
            - Female
          description: Gender of party
          example: Male
        dob:
          type: string
          format: date
          description: Date of birth of party
        age:
          type: number
          description: Age of the party
          example: 26
        ssn:
          type: string
          description: Party SSN. In case if non individual it should be Tax Id
          minLength: 9
          maxLength: 9
          example: "121328426"
        driverNumber:
          type: string
          description: Driver license number
          example: T61217265934
        driverState:
          type: string
          enum:
            - AL
            - AK
            - AZ
            - AR
            - CA
            - CO
            - CT
            - DC
            - DE
            - FL
            - GA
            - HI
            - ID
            - IL
            - IN
            - IA
            - KS
            - KY
            - LA
            - ME
            - MD
            - MA
            - MI
            - MN
            - MS
            - MO
            - MT
            - NE
            - NV
            - NH
            - NJ
            - NM
            - NY
            - NC
            - ND
            - OH
            - OK
            - OR
            - PA
            - RI
            - SC
            - SD
            - TN
            - TX
            - UT
            - VT
            - VA
            - WA
            - WV
            - WI
            - WY
          description: State Code
          example: AL
        noDriversLicenseInd:
          type: string
          enum:
            - Yes
            - No
            - Unknown
          description: Flag for Driver License
          example: No
        address1:
          type: string
          description: Addres line 1
          example: Wt Road
        address2:
          type: string
          description: Addres line 2
          example: St Street
        city:
          type: string
          description: City name
          example: Test City
        state:
          type: string
          enum:
            - AL
            - AK
            - AZ
            - AR
            - CA
            - CO
            - CT
            - DC
            - DE
            - FL
            - GA
            - HI
            - ID
            - IL
            - IN
            - IA
            - KS
            - KY
            - LA
            - ME
            - MD
            - MA
            - MI
            - MN
            - MS
            - MO
            - MT
            - NE
            - NV
            - NH
            - NJ
            - NM
            - NY
            - NC
            - ND
            - OH
            - OK
            - OR
            - PA
            - RI
            - SC
            - SD
            - TN
            - TX
            - UT
            - VT
            - VA
            - WA
            - WV
            - WI
            - WY
          description: State Code
          example: AL
        zip:
          type: string
          description: Zip Code. Max char allowed is 9.
          maxLength: 9
          example: "123456"
        birthCountry:
          type: string
          enum:
            - AF
            - AX
            - AL
            - DZ
            - AS
            - AD
            - AO
            - AI
            - AQ
            - AG
            - AR
            - AM
            - AN
            - AW
            - AU
            - AT
            - AZ
            - BS
            - BH
            - BD
            - BB
            - BY
            - BE
            - BZ
            - BJ
            - BM
            - BT
            - BO
            - BQ
            - BA
            - BW
            - BV
            - BR
            - IO
            - BN
            - BG
            - BF
            - BI
            - CV
            - KH
            - CM
            - CA
            - KY
            - CF
            - TD
            - CL
            - CN
            - CX
            - CC
            - CO
            - KM
            - CD
            - CG
            - CK
            - CR
            - CI
            - HR
            - CU
            - CW
            - CY
            - CZ
            - DK
            - DJ
            - DM
            - DO
            - EC
            - EG
            - SV
            - GQ
            - ER
            - EE
            - SZ
            - ET
            - FK
            - FO
            - FJ
            - FI
            - FR
            - GF
            - PF
            - TF
            - GA
            - GM
            - GE
            - DE
            - GH
            - GI
            - GR
            - GL
            - GD
            - GP
            - GU
            - GT
            - GG
            - GN
            - GW
            - GY
            - HT
            - HM
            - VA
            - HN
            - HK
            - HU
            - IS
            - IN
            - ID
            - IR
            - IQ
            - IE
            - IM
            - IL
            - IT
            - JM
            - JP
            - JE
            - JO
            - KZ
            - KE
            - KI
            - KP
            - KR
            - KW
            - KG
            - LA
            - LV
            - LB
            - LS
            - LR
            - LY
            - LI
            - LT
            - LU
            - MO
            - MK
            - MG
            - MW
            - MY
            - MV
            - ML
            - MT
            - MH
            - MQ
            - MR
            - MU
            - YT
            - MX
            - FM
            - MD
            - MC
            - MN
            - ME
            - MS
            - MA
            - MZ
            - MM
            - NA
            - NR
            - NP
            - NL
            - NC
            - NZ
            - NI
            - NE
            - NG
            - NU
            - NF
            - MP
            - NO
            - OM
            - PK
            - PW
            - PS
            - PA
            - PG
            - PY
            - PE
            - PH
            - PN
            - PL
            - PT
            - PR
            - QA
            - RE
            - RO
            - RU
            - RW
            - BL
            - SH
            - KN
            - LC
            - MF
            - PM
            - VC
            - WS
            - SM
            - ST
            - SA
            - SN
            - RS
            - SC
            - SL
            - SG
            - SX
            - SK
            - SI
            - SB
            - SO
            - ZA
            - GS
            - SS
            - ES
            - LK
            - SD
            - SR
            - SJ
            - SE
            - CH
            - SY
            - TW
            - TJ
            - TZ
            - TH
            - TL
            - TG
            - TK
            - TO
            - TT
            - TN
            - TR
            - TM
            - TC
            - TV
            - UG
            - UA
            - AE
            - GB
            - UM
            - US
            - UY
            - UZ
            - VU
            - VE
            - VN
            - VG
            - VI
            - WF
            - EH
            - XK
            - YE
            - ZM
            - ZW
            - Other
          description: Birth Country
          example: US
        identification:
          type: array
          items:
            type: object
            properties:
              governmentIdType:
                type: string
                enum:
                  - Passport
                  - StateId
                  - SSN
                example: Passport
              governmentId:
                type: string
                example: "213121414"
              jurisdiction:
                type: string
                enum:
                  - AL
                  - AK
                  - AZ
                  - AR
                  - CA
                  - CO
                  - CT
                  - DC
                  - DE
                  - FL
                  - GA
                  - HI
                  - ID
                  - IL
                  - IN
                  - IA
                  - KS
                  - KY
                  - LA
                  - ME
                  - MD
                  - MA
                  - MI
                  - MN
                  - MS
                  - MO
                  - MT
                  - NE
                  - NV
                  - NH
                  - NJ
                  - NM
                  - NY
                  - NC
                  - ND
                  - OH
                  - OK
                  - OR
                  - PA
                  - RI
                  - SC
                  - SD
                  - TN
                  - TX
                  - UT
                  - VT
                  - VA
                  - WA
                  - WV
                  - WI
                  - WY
                  - GU
                  - PR
                description: State Code if applicable. Provided in case of state issued Id
                example: AL
        phone:
          type: string
          description: Phone number
          example: 111-111-2222
        email:
          type: string
          description: Email Id of the party
          example: test@abc.com
        emailType:
          type: string
          enum:
            - Personal
            - Business
          description: Type of email
          example: Business
        communicationPreference:
          type: string
          enum:
            - Mail
            - Email
            - Phone
          description: Communication preferences
          example: Email
        classification:
          type: string
          enum:
            - Individual
            - Business
            - Trust
            - Corporation
            - Partnership
            - Other
            - Group of Individuals
            - Estate
            - Child
          description: Party classification
          example: Individual
        dateOfTrust:
          type: string
          format: date
          description: Date of trust
        trusteeName:
          type: array
          items:
            type: object
            properties:
              fullName:
                type: string
                description: Trusee Name
                example: John Doe
        stateExecution:
          type: string
          enum:
            - AL
            - AK
            - AZ
            - AR
            - CA
            - CO
            - CT
            - DC
            - DE
            - FL
            - GA
            - HI
            - ID
            - IL
            - IN
            - IA
            - KS
            - KY
            - LA
            - ME
            - MD
            - MA
            - MI
            - MN
            - MS
            - MO
            - MT
            - NE
            - NV
            - NH
            - NJ
            - NM
            - NY
            - NC
            - ND
            - OH
            - OK
            - OR
            - PA
            - RI
            - SC
            - SD
            - TN
            - TX
            - UT
            - VT
            - VA
            - WA
            - WV
            - WI
            - WY
          description: State Code
          example: AL
        trustBeneficiaries:
          type: array
          items:
            type: object
            properties:
              fullName:
                type: string
                description: Trust Bene Name
                example: John Smith
        relationship:
          type: string
          enum:
            - Aunt
            - Brother
            - Business
            - Business Associate
            - Charity
            - Child
            - Co-Mortgager
            - Cousin
            - Daughter
            - Dependant
            - Domestic Partner
            - Estate
            - Executors
            - Father
            - Fiance
            - Fiancee
            - Former Spouse
            - Friend
            - God Child
            - God Parent
            - Grandchild
            - Grandparent
            - Great Grandchild
            - Great Grandparent
            - Legal Guardian
            - Life Partner
            - Mother
            - Nephew
            - Niece
            - Parent
            - Parents In Law
            - Sibling
            - Sister
            - Son
            - Spouse
            - Stepfather
            - Stepmother
            - Trust
            - Uncle
            - Self
            - Other
          description: Relationship with insured
          example: Father
```
