Policy Transactions
Eligibility Check Coverage Joint Insured Role Change
Evaluates whether the policy is eligible for a Coverage Joint Insured role change transaction.
Generic Party Role Change endpoint, shared across all multi-party-update transactions (Payee, Trustee, Power of Attorney, Owner, Joint Owner, Authorized Signatory, Coverage Joint Insured, and future party roles using the same MultiPartyRoleChangeRequest/PartyUpdate request format).
post
Path Parameters
planCodestringrequired
Plan Code
policyNumberstringrequired
Policy Number
Response
application/json
Response
application/json
Coverage Joint Insured Role Change Eligibility Success Response
TransactionResponse
statusstring
Allowed values:successfailure
errorarray[object]
Show Child Parameters
quoteResponseobject
post/bpm/v1/policies/{planCode}/{policyNumber}/parties/CoverageJointInsured/eligibilitycheck
Authentication
Path Parameters
application/json
Validate Coverage Joint Insured Role Change
Validates the Coverage Joint Insured role change request (one or more PartyUpdate entries -
ADD/UPDATE/DELETE) against business rules before submission.
Generic Party Role Change endpoint, shared across all multi-party-update transactions (Payee, Trustee, Power of Attorney, Owner, Joint Owner, Authorized Signatory, Coverage Joint Insured, and future party roles using the same MultiPartyRoleChangeRequest/PartyUpdate request format).
post
Path Parameters
planCodestringrequired
Plan Code
policyNumberstringrequired
Policy Number
Body
application/json
Body
application/json
MultiPartyRoleChangeRequest
Generic request body for a party role change transaction (pa-bpm-txn-common
MultiPartyRoleChangeRequest), shared across all multi-party-update
transactions (Payee, Trustee, Power of Attorney, Owner/Joint Owner,
Authorized Signatory, Coverage Joint Insured, and future party roles).
Each party role is exposed at its own dedicated path (see the
…/parties/{role}/… operations); this schema is the shared contract
across all of them.
planCodestring
Plan code (may duplicate path parameter)
policyNumberstring
Policy number (may duplicate path parameter)
caseIdstring
Zinnia Live Case ID
Example:CA0000007389
correlationIdstring
The unique ID to track transaction request across all systems
Example:e3bdb22b-790f-4357-ae60-42cdb0ff0d12
carrierIdstring
Carrier identifier
Example:FNWL
effectiveDatestring(date)required
Effective date for the party role change
Example:2026-07-24
requestSourcestring
Origin of the request
Allowed values:DATA_ENTRYSELF_SERVE
partyUpdatesarray[object]required
A single party change entry (pa-bpm-txn-common PartyUpdateDto). One
MultiPartyRoleChangeRequest carries a list of these - one per party being
added, updated, or removed in this transaction.
>= 1 items
Show Child Parameters
signaturesarray[object]
Signature details for the agent change
Show Child Parameters
documentsarray[object]
Supporting document reference for a party role change
Show Child Parameters
selfServeFlowboolean
Whether the request originated from a self-serve flow
Example:true
supportingDocumentAttachedboolean
Indicates whether supporting documents are attached
Example:true
changeReasonstring
Reason for the change
Response
application/json
Response
application/json
Coverage Joint Insured Role Change Validation Success Response
TransactionResponse
statusstring
Allowed values:successfailure
errorarray[object]
Show Child Parameters
quoteResponseobject
post/bpm/v1/policies/{planCode}/{policyNumber}/parties/CoverageJointInsured/validation
Authentication
Path Parameters
Body
{
"correlationId": "e3bdb22b-790f-4357-ae60-42cdb0ff0d12",
"planCode": "EVGFIA909",
"policyNumber": "EVFIA095509100",
"effectiveDate": "2026-07-24",
"requestSource": "DATA_ENTRY",
"partyUpdates": [
{
"action": "ADD",
"partyRole": "CoverageJointInsured",
"party": {
"firstName": "John",
"lastName": "Doe",
"dateOfBirth": "1980-05-12",
"gender": "M"
}
}
]
}
application/json
Submit Coverage Joint Insured Role Change
Submits the Coverage Joint Insured role change transaction for processing.
Generic Party Role Change endpoint, shared across all multi-party-update transactions (Payee, Trustee, Power of Attorney, Owner, Joint Owner, Authorized Signatory, Coverage Joint Insured, and future party roles using the same MultiPartyRoleChangeRequest/PartyUpdate request format).
post
Path Parameters
planCodestringrequired
Plan Code
policyNumberstringrequired
Policy Number
Body
application/json
Body
application/json
MultiPartyRoleChangeRequest
Generic request body for a party role change transaction (pa-bpm-txn-common
MultiPartyRoleChangeRequest), shared across all multi-party-update
transactions (Payee, Trustee, Power of Attorney, Owner/Joint Owner,
Authorized Signatory, Coverage Joint Insured, and future party roles).
Each party role is exposed at its own dedicated path (see the
…/parties/{role}/… operations); this schema is the shared contract
across all of them.
planCodestring
Plan code (may duplicate path parameter)
policyNumberstring
Policy number (may duplicate path parameter)
caseIdstring
Zinnia Live Case ID
Example:CA0000007389
correlationIdstring
The unique ID to track transaction request across all systems
Example:e3bdb22b-790f-4357-ae60-42cdb0ff0d12
carrierIdstring
Carrier identifier
Example:FNWL
effectiveDatestring(date)required
Effective date for the party role change
Example:2026-07-24
requestSourcestring
Origin of the request
Allowed values:DATA_ENTRYSELF_SERVE
partyUpdatesarray[object]required
A single party change entry (pa-bpm-txn-common PartyUpdateDto). One
MultiPartyRoleChangeRequest carries a list of these - one per party being
added, updated, or removed in this transaction.
>= 1 items
Show Child Parameters
signaturesarray[object]
Signature details for the agent change
Show Child Parameters
documentsarray[object]
Supporting document reference for a party role change
Show Child Parameters
selfServeFlowboolean
Whether the request originated from a self-serve flow
Example:true
supportingDocumentAttachedboolean
Indicates whether supporting documents are attached
Example:true
changeReasonstring
Reason for the change
Response
application/json
Response
application/json
Submit Transaction Successful
TransactionAcceptedResponse
correlationIdstring
Unique identifier which used by every system to trace the request
Example:3a2a3435-2089-4b81-9959-e0d569ccf4f0
caseIdstring
Zinnia Live Case ID
Example:CA0000369469
caseStatusstring
Zinnia Live Case Status
Example:IN_PROGRESS
pdfIdstring
Identifier for the generated or associated PDF document (e.g. OnBase document number). Returned on systematic program setup and update submit when available.
Example:DOC-10004567
post/bpm/v1/policies/{planCode}/{policyNumber}/parties/CoverageJointInsured
Authentication
Path Parameters
Body
{
"correlationId": "e3bdb22b-790f-4357-ae60-42cdb0ff0d12",
"planCode": "EVGFIA909",
"policyNumber": "EVFIA095509100",
"effectiveDate": "2026-07-24",
"requestSource": "DATA_ENTRY",
"partyUpdates": [
{
"action": "ADD",
"partyRole": "CoverageJointInsured",
"party": {
"firstName": "John",
"lastName": "Doe",
"dateOfBirth": "1980-05-12",
"gender": "M"
}
}
]
}
application/json
Freelook cancellation request
If freelook endDate is less than or equal to policy effective Date, cancel the policy based on the request
post
Path Parameters
planCodestringrequired
policyNumberstringrequired
Policy Number
Body
application/json
Body
application/json
FreeLookCancellationRequest
correlationIdstring
The unique ID to track transaction request across all systems
Example:657b717b7dcf554abf9ef067
effectiveDatestring(date)required
Date (with pattern “yyyy-mm-dd”)
Match pattern:([0-9]{4})-([0-9]{2})-([0-9]{2})
transactionAmountsobjectrequired
Show Child Parameters
payeeOrBeneficiaryobject
Show Child Parameters
partiesarray[object]required
Show Child Parameters
reverseInitiatorboolean
Property to isolate source transaction(s) that initiated the reversal
caseIdstring
Zinnia Live Case ID
Example:CA0000007389
Response
application/json
Response
application/json
Success
TransactionAcceptedResponse
correlationIdstring
Unique identifier which used by every system to trace the request
Example:3a2a3435-2089-4b81-9959-e0d569ccf4f0
caseIdstring
Zinnia Live Case ID
Example:CA0000369469
caseStatusstring
Zinnia Live Case Status
Example:IN_PROGRESS
pdfIdstring
Identifier for the generated or associated PDF document (e.g. OnBase document number). Returned on systematic program setup and update submit when available.
Example:DOC-10004567
post/policy/v1/transactions/{planCode}/{policyNumber}/freelookcancellation/eligibilitycheck
Authentication
Path Parameters
Body
{
"effectiveDate": "effectiveDate",
"transactionAmounts": {
"disbursementType": "GROSS",
"disbursementPaymentForm": "DTCC"
},
"parties": [
{
"partyId": "Party_PI_1",
"paymentForm": "DTCC",
"allocationPercentage": 100
}
]
}
application/json
Update Initial Death Claim Notification Method
Updates the notification method (and related beneficiary/change details) for a party on an initial death claim case.
put
Path Parameters
planCodestringrequired
Plan Code
Example:EVIU101
policyNumberstringrequired
Policy Number
Example:EVIUL7RED022
partyIdstringrequired
Identifier of the party whose notification method is being updated
Example:e6954b3d-a0ef-47dc-ac49-046db6bc7da7
Body
application/json
Body
application/json
IdnNotificationMethodUpdate
Internal payload used to update the notification method (and related beneficiary/change details) for a party on an initial death claim case.
zlCaseIdstring
Example:ZL-CA0000369469
businessKeystring
Example:CA0000369469
correlationidstring
Example:3a2a3435-2089-4b81-9959-e0d569ccf4f0
sorSystemstring
Example:LIFECAD
sourceSystemstring
Example:ZAHARA
carrierIdstring
Example:OTP_DC
planCodestring
Example:EVIU101
policyNumberstring
Example:EVIUL7RED022
updateDatestring(date)
Date (with pattern “yyyy-mm-dd”)
Example:2026-10-12
beneficiaryRecordIdstring
Example:BEN-10045
beneficiaryobject
Beneficiary/party details used internally by notification-method update processing.
Show Child Parameters
beneficiaryChangeDetailobject
Show Child Parameters
contactEstablishedboolean
Example:true
taskActionsarray[string]
Allowed values:RESEND_PACKETCONTACT_ESTABLISHEDUPDATE_NOTIFICATION_METHOD
Example:UPDATE_NOTIFICATION_METHOD
Response
application/json
Response
application/json
Update Notification Method Transaction Accepted
TransactionAcceptedResponse
correlationIdstring
Unique identifier which used by every system to trace the request
Example:3a2a3435-2089-4b81-9959-e0d569ccf4f0
caseIdstring
Zinnia Live Case ID
Example:CA0000369469
caseStatusstring
Zinnia Live Case Status
Example:IN_PROGRESS
pdfIdstring
Identifier for the generated or associated PDF document (e.g. OnBase document number). Returned on systematic program setup and update submit when available.
Example:DOC-10004567
put/policy/v1/transactions/{planCode}/{policyNumber}/parties/{partyId}/initialdeathclaim/notificationmethod
Authentication
Path Parameters
Body
{}
application/json