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

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

# GetPolicyDetails

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    PolicyInformation:
      type: object
      properties:
        policyNumber:
          type: string
          description: The Policy Number is a unique identifier assigned to a life
            insurance or annuity contract by the insurance carrier. It serves as
            the official reference number for tracking, managing, and servicing
            the policy throughout its lifetime
        policyStatus:
          type: string
          description: The Policy Status refers to the current standing of a life
            insurance or annuity contract, indicating whether it is active,
            inactive, lapsed, or terminated. The status determines whether the
            policyholder has coverage and whether policy benefits remain in
            effect
        productCode:
          type: string
        product:
          type: string
        faceAmount:
          type: number
        modalPremium:
          type: number
        paymentFrequency:
          type: string
        riskClassCode:
          type: string
        riskClass:
          type: string
        tableRatingCode:
          type: string
        tableRating:
          type: string
        flatExtraAmt:
          type: object
        flatExtraDuration:
          type: object
        ownerInformation:
          $ref: "#/components/schemas/OwnerInformation"
        insuredInformation:
          type: array
          items:
            $ref: "#/components/schemas/InsuredInformation"
        beneficiaryInformation:
          type: array
          items:
            $ref: "#/components/schemas/BeneficiaryInformation"
        agentInformation:
          $ref: "#/components/schemas/AgentInformation"
    MessageResponse:
      type: object
      properties:
        status:
          type: string
        statusCode:
          type: integer
          format: int32
        message:
          type: object
    OwnerInformation:
      type: object
      properties:
        type:
          type: string
        suffix:
          type: object
          description: The suffix of the owner party name
        relationshiptoInsured:
          type: string
          description: The type of relationship to the owner
        roleCode:
          type: string
        roleName:
          type: string
        roleDescription:
          type: string
        fullName:
          type: string
          description: The full name of the owner party
        firstName:
          type: string
          description: The first name of the owner party
        middleName:
          type: string
          description: The middle name of the owner party
        lastName:
          type: string
          description: The last name of the owner party
        gender:
          type: string
          description: The gender of the owner party
        cellPhone:
          type: string
        businessPhone:
          type: object
        homePhone:
          type: string
        eMailAddress:
          type: object
        preferredCommunication:
          type: string
        city:
          type: string
        stateCode:
          type: string
        state:
          type: string
        stateDescription:
          type: string
        zip:
          type: string
        dateOfBirth:
          type: string
          description: The date of birth of the owner
          format: date-time
        sSN:
          type: string
        driverLicenseNumber:
          type: string
        driverLicenseState:
          type: string
        addressLine1:
          type: string
        addressLine2:
          type: string
        addressLine3:
          type: string
        addressLine4:
          type: object
        ssn:
          type: string
        emailAddress:
          type: object
    InsuredInformation:
      type: object
      properties:
        roleCode:
          type: string
        roleName:
          type: string
        roleDescription:
          type: string
        fullName:
          type: string
          description: The full name of the insured party
        firstName:
          type: string
          description: The first name of the insured party
        middleName:
          type: string
          description: The middle name of the insured party
        lastName:
          type: string
          description: The last name of the insured party
        gender:
          type: string
          description: The gender of the insured party
        cellPhone:
          type: string
        businessPhone:
          type: object
        homePhone:
          type: string
        eMailAddress:
          type: object
        preferredCommunication:
          type: string
        city:
          type: string
        stateCode:
          type: string
        state:
          type: string
        stateDescription:
          type: string
        zip:
          type: string
        dateOfBirth:
          type: string
          format: date-time
          description: The date of birth of the insured party
        sSN:
          type: string
        driverLicenseNumber:
          type: string
        driverLicenseState:
          type: string
        addressLine1:
          type: string
        addressLine2:
          type: string
        addressLine3:
          type: string
        addressLine4:
          type: object
        ssn:
          type: string
        emailAddress:
          type: object
    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
    AgentInformation:
      type: object
      properties:
        agentExternalId:
          type: object
          description: The Id which user enters(Id validated in MCS) - Agent External ID
            and Compnay ID uniquely identifies the right Agent
        agentType:
          type: object
    GetPolicyDetails:
      type: object
      properties:
        policyInformation:
          $ref: "#/components/schemas/PolicyInformation"
        messageResponse:
          $ref: "#/components/schemas/MessageResponse"
```