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

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

# DeathClaimNotification

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    TransactionReason:
      type: string
      description: The specific reason or purpose for the transaction being processed
      enum:
        - ONETIMEPREMIUM
        - GRACEPERIODPREMIUM
        - REINSTATEMENTPREMIUM
        - EXCHANGE1035
        - SURRENDER
        - AMOUNTEXCESSTOMEC
        - AMOUNTEXCESSTOGUIDELINE
        - CURRENTVALUE
        - COSTBASIS
        - GUIDELINESINGLEPREMIUM
        - GUIDELINELEVELPREMIUM
        - SEVENPAYPREMIUM
        - TOTALYTDPREMIUMAMOUNT
        - FACEDECREASECOVERAGE
        - FACEINCREASECOVERAGE
        - MECAUTHORIZATION
        - INITIALPREMIUMEXPIRATION
        - COMPLIANCE
        - STARTINGPRICE
        - LUMPSUM
        - FIVEYEARDEFERRAL
        - SPOUSALCONTINUATION
        - DISCOUNT
        - CONTROLBUSINESSINDICATOR
        - NATIONALCHANGEOFADDRESS
        - DATEOFDEATH
        - INITIALDEATHNOTIFICATION
        - PRODUCTDEFAULT
        - GWBRIDERDISBURSEMENT
        - GWBPHASECHANGE
        - PREMIUMLOAN
        - PAYMENTDUEDATE
    AdhocExternalIdentifiers:
      type: object
      properties:
        referenceNumber:
          type: string
          description: The unique payment reference number for all premium-related
        externalTransactionId:
          type: string
          description: The unique ID to identify transaction on carrier side
    NotificationOfDeathClaimAdhocPolicy:
      type: object
      properties:
        deathBenefit:
          $ref: "#/components/schemas/NotificationOfDeathClaimAdhocDeathBenefit"
        parties:
          description: Array of parties involved in the death notification
          type: array
          items:
            $ref: "#/components/schemas/PartiesDeathNotification"
    NotificationOfDeathClaimAdhocDeathBenefit:
      type: object
      properties:
        disputedDebtAmount:
          type: number
          example: 90
          description: Amount in question of disagreement between the creditor and the
            committee as to the existence of a debt or the amount owed by the
            committee
          format: double
    PartiesDeathNotification:
      type: object
      properties:
        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_PB_Primary_Bene_1
        partyRole:
          $ref: "#/components/schemas/PartyRole"
        deathDetails:
          $ref: "#/components/schemas/DeathDetail"
    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
    DeathDetail:
      type: object
      properties:
        dateOfDeath:
          type: string
          format: date
          description: The date on which the insured/annuitant died
          example: 2023-01-01
        causeOfDeath:
          $ref: "#/components/schemas/CauseOfDeath"
        deathNotificationDate:
          type: string
          format: date
          description: The date on which carrier was notified of the death
          example: 2023-01-01
        dateOfDueProof:
          type: string
          format: date
          description: Date the appropriate death paperwork was received (example - death
            certificate receive date)
          example: 2023-01-01
    CauseOfDeath:
      type: string
      enum:
        - AIDS
        - ACCIDENTOTHER
        - ACCIDENTBYFIRE
        - ACCIDENTALDROWNING
        - ACCIDENTALFALL
        - ACCIDENTALPOISONING
        - AIRCRAFTACCIDENT
        - ALCOHOLISM
        - ALLERGICDISORDERS
        - ANEMIA
        - APPENDICITIS
        - ARTERIALDISEASE
        - AVITAMINOSIS
        - BENIGNTUMOR
        - BIRTHINJURY
        - BRONCHITIS
        - BRONCHOPNEUMONIA
        - COVID
        - CANCERBONE
        - CANCERBREAST
        - CANCERCERVIX
        - CANCERESOPHAGUS
        - CANCERINTESTINE
        - CANCERLARYNX
        - CANCERLUNG
        - CANCERMOUTH
        - CANCEROTHER
        - CANCERPROSTATE
        - CANCERRECTUM
        - CANCERSKIN
        - CANCERSTOMACH
        - CANCERUTERUS
        - CIRCULATORYOTHER
        - CIRRHOSIS
        - CONGENITALDISORDER
        - DIABETES
        - DIGESTIVEDISEASEOTHER
        - DIPTHERIA
        - DRUGOVERDOSE
        - DYSENTERY
        - EARINFECTION
        - EMPHYSEMA
        - ENCEPHALITIS
        - ENLARGEDPROSTATE
        - EPILEPSY
        - FIREARMACCIDENT
        - FLU
        - GALLSTONE
        - GASTRITIS
        - GASTROENTERITIS
        - GOITERNONTOXIC
        - HEARTARTERIOSCLEROTIC
        - HEARTOTHER
        - HEARTRHEUMATIC
        - HERNIA
        - HOMICIDE
        - HYPERTENSIONHEART
        - HYPERTENSIONNOHEART
        - KIDNEYINFECTION
        - KIDNEYSTONE
        - LEUKAEMIA
        - LUNGDISEASEOTHER
        - LYMPHORSARCOMA
        - MACHINERYACCIDENT
        - MALARIA
        - MEASLES
        - MENINGITISMENIN
        - MENINGITISNONMENIN
        - MENTALDISORDER
        - MOTORVEHICLEACCIDENT
        - MULTIPLESCLEROSIS
        - NATURALDEATH
        - NEPHRITIS
        - NERVOUSSYSTEMOTHER
        - NEWBORNDISORDEROTHER
        - NEWBORNINFECTION
        - OSTEOMYELITIS
        - PARASITICDISEASEOTHER
        - PLEURISY
        - PNEUMONIALOBAR
        - PNEUMONIAOTHER
        - POLIO
        - PREGNANCYDISORDER
        - RHEUMATICFEVER
        - SCARLETFEVER
        - SENILITY
        - SEPTICAEMIA
        - SKINDISEASEOTHER
        - SKININFECTION
        - SUICIDE
        - SYPHILIS
        - TETANUS
        - THYROTOXICOSIS
        - TUBERCULOSIS
        - TYPHOID
        - TYPHUS
        - ULCEROFDUODENUM
        - ULCEROFSTOMACH
        - UNKNOWN
        - URINARYDISEASEOTHER
        - VASCULARLESIONS
        - WAR
        - WHOOPINGCOUGH
        - PENDINGINVESTIGATION
        - ACCIDENT
    DeathClaimNotification:
      type: object
      properties:
        correlationId:
          type: string
          example: 657b717b7dcf554abf9ef067
          description: The unique ID to track transaction request across all systems
        effectiveDate:
          type: string
          example: 2023-01-01
          description: Date (with pattern "yyyy-mm-dd") when the transaction was
            originally scheduled or expected to happen, can be a non-business
            day
          format: date
        reverseInitiator:
          type: boolean
          description: Property to isolate source transaction(s) that initiated the reversal
          default: false
        transactionReason:
          $ref: "#/components/schemas/TransactionReason"
        externalIdentifiers:
          $ref: "#/components/schemas/AdhocExternalIdentifiers"
        policy:
          $ref: "#/components/schemas/NotificationOfDeathClaimAdhocPolicy"
```