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

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

# PartyRoles

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    PartyRole:
      type: string
      enum:
        - OWNER
        - PRIMARYBENEFICIARY
        - CONTINGENTBENEFICIARY
        - INSURED
        - PAYOR
        - PAYEE
        - AGENT
        - PRIMARYWRITINGAGENT
        - PRIMARYSERVICINGAGENT
        - ADDITIONALSERVICINGAGENT
        - ADDITIONALWRITINGAGENT
        - THIRDPARTYDESIGNEE
        - JOINTOWNER
        - COVERAGEINSURED
        - ASSIGNEE
        - ANNUITANT
        - EXCHANGECOMPANY
        - JOINTANNUITANT
        - GRANTOR
        - TRUSTEE
        - POWEROFATTORNEY
        - AUTHORIZEDSIGNATORY
        - OTHERINTERESTEDPARTY
        - CONTINGENTOWNER
        - THIRDPARTYADMINISTRATOR
        - CARRIER
        - SUCCESSORTRUSTEE
        - COVERAGEJOINTINSURED
    PartyRoles:
      type: object
      properties:
        partyRole:
          $ref: "#/components/schemas/PartyRole"
        partyRoleId:
          type: string
          description: The Party Role ID is a unique identifier assigned to a specific
            role that a party (individual or entity) plays within an insurance
            or annuity contract. It serves to distinctly track and manage the
            relationship between the party and the contract, especially when a
            party may have multiple roles across different policies or within
            the same policy
        partyId:
          type: string
          description: Party ID is a unique identifier assigned to a party (individual or
            entity) involved in an insurance or annuity contract. This
            identifier helps ensure accurate data exchange and tracking across
            insurance transactions
          example: Party_PI_1
        startDate:
          type: string
          description: Date the Party was added to the Policy
          example: 2023-01-01
          format: date
        endDate:
          type: string
          description: Date the Party was Terminated from the Policy
          example: 2023-01-01
          format: date
```