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

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

# BeneficiaryInformation

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    BeneficiaryInformation:
      type: object
      properties:
        type:
          type: string
        suffix:
          type: object
          description: The suffix of the beneficiary party name
        relationshipToInsured:
          type: string
          description: The type of relationship to the beneficiary
        percentageOfProceed:
          type: string
        roleCode:
          type: string
        roleName:
          type: string
        roleDescription:
          type: string
        fullName:
          type: string
          description: The full name of the beneficiary party
        firstName:
          type: string
          description: The first name of the beneficiary party
        middleName:
          type: string
          description: The middle name of the beneficiary party
        lastName:
          type: string
          description: The last name of the beneficiary party
        gender:
          type: object
          description: The gender of the beneficiary party
        cellPhone:
          type: object
        businessPhone:
          type: object
        homePhone:
          type: string
        eMailAddress:
          type: object
        preferredCommunication:
          type: object
        city:
          type: object
        stateCode:
          type: object
        state:
          type: object
        stateDescription:
          type: object
        zip:
          type: object
        dateOfBirth:
          type: string
          description: The date of birth of the beneficiary party
          format: date-time
        sSN:
          type: string
        driverLicenseNumber:
          type: object
        driverLicenseState:
          type: object
        addressLine1:
          type: string
        addressLine2:
          type: string
        addressLine3:
          type: string
        addressLine4:
          type: object
        ssn:
          type: string
        emailAddress:
          type: object
```