Policy Transactions
BillingFeatureChangeRequest
objectRequest body for billing feature change validation
(POST /bpm/v1/policies/{planCode}/{policyNumber}/billingfeaturechange/validation
and policy API alias).
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 billing feature change
Example:2026-07-24
transactionReasonstring
Reason for initiating the billing feature change transaction
Allowed values:AMOUNTFREQUENCYPAYMENTDUEDATE
Example:AMOUNT
policyFeaturesarray[object]required
Billing policy feature details for the change request
>= 1 items
Show Child Parameters
signaturesarray[object]
Signature details for billing feature change
Show Child Parameters
documentsarray[object]
Supporting document reference for billing feature 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
Example
PolicyCoverageChangesRequest
objectRequest body for a bundle of in-force coverage/rider changes
(POST /bpm/v1/policies/{planCode}/{policyNumber}/policyCoverageChanges
and policy API alias).
caseIdstringrequired
Unique identifier of the in-force case associated with this policy update, used to correlate the request with the case management system
Example:CA1234567890
correlationIdstring(uuid)required
The unique ID to track this transaction request across all systems
Example:381ee1cc-7f34-47b1-a007-948d26b68a0f
effectiveDatestring(date)required
Transaction-level effective date, used as the default effective date for any policyUpdateRequest item that does not specify its own effectiveDate
Example:2026-07-15
externalIdentifiersobject
Show Child Parameters
policyUpdateRequest
One Ofarray[object]required
A single policy-update request item. The shape of the remaining properties depends on requestType.
>= 1 items
DeathBenefitOptionChangeobject
Death Benefit Option change request item
Show Child Parameters
paymentobject
Recurring premium/billing arrangement for this transaction, required only if at least one policyUpdateRequest item impacts premium (BASECOVERAGEUPDATE, RIDERADD, RIDERUPDATE).
Show Child Parameters
oneTimePaymentobject
One-time payment accompanying this transaction, present only when the transaction includes a one-time payment
Show Child Parameters
illustrationsobject
Show Child Parameters
partiesarray[object]
Parties referenced by this transaction’s policyUpdateRequest, payment, and oneTimePayment items
Show Child Parameters
underwritingobject
Underwriting decision evaluated for this policy update, present when an underwriting case was evaluated
Show Child Parameters
identifiersarray[object]
Business identifier associated with the case, using Zinnia’s existing {identifier, value} convention
Show Child Parameters
Example
PolicyCoverageChangesExternalIdentifiers
objectexternalTransactionIdstring
Transaction identifier assigned by the external/source system submitting the request
Example:test
referenceNumberstring
Additional reference number supplied by the external system for tracking purposes
Example:uniquetest1233
Example
PolicyCoverageChangesRequestItem
objectA single policy-update request item. The shape of the remaining properties depends on requestType.
One OfrequestTypestringrequired
Discriminator identifying this item as a Death Benefit Option change request
Allowed values:DEATHBENEFITOPTIONCHANGE
Example:DEATHBENEFITOPTIONCHANGE
coverageIdstring
Coverage ID received from the policy admin system
Example:Base_Coverage
coverageTypestring
Type of the coverage
Allowed values:BASETERMSUPPLEMENTAL
Example:BASE
deathBenefitOptionstringrequired
New death benefit option elected for the coverage
Allowed values:LEVELINCREASING
Example:LEVEL
deathBenefitComplianceTeststring
IRC compliance test the policy is administered under after the change
Allowed values:GPTCVAT
Example:GPT
Example
DeathBenefitOptionChange
objectDeath Benefit Option change request item
requestTypestringrequired
Discriminator identifying this item as a Death Benefit Option change request
Allowed values:DEATHBENEFITOPTIONCHANGE
Example:DEATHBENEFITOPTIONCHANGE
coverageIdstring
Coverage ID received from the policy admin system
Example:Base_Coverage
coverageTypestring
Type of the coverage
Allowed values:BASETERMSUPPLEMENTAL
Example:BASE
deathBenefitOptionstringrequired
New death benefit option elected for the coverage
Allowed values:LEVELINCREASING
Example:LEVEL
deathBenefitComplianceTeststring
IRC compliance test the policy is administered under after the change
Allowed values:GPTCVAT
Example:GPT
Example