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

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

# PolicyDetailsChangeRequest

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    PolicyAttributeAdjustment:
      type: object
      properties:
        policyAttribute:
          $ref: "#/components/schemas/PolicyAttribute"
        attributeValue:
          type: string
          description: New value for the attribute (e.g. `"true"` / `"false"` for MEC
            authorization).
          example: "true"
      required:
        - policyAttribute
        - attributeValue
    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
    PolicyAttribute:
      type: string
      enum:
        - MODIFIEDENDOWMENTCONTRACTAUTHORIZATION
    PolicyDetailsChangeRequest:
      type: object
      properties:
        correlationId:
          type: string
          example: 864e43a0-2c2f-4a11-9d7f-69ed40115066
          description: The unique ID to track transaction request across all systems
        effectiveDate:
          type: string
          example: 2026-04-10
          format: date
          description: Date when the transaction was originally scheduled or expected to
            happen. It can be a non-business day
        reverseInitiator:
          type: boolean
          default: false
          description: When true, allows a backdated financial transaction by reversing to
            the effective date, applying the change, and reprocessing subsequent
            transactions.
        valueAdjustment:
          $ref: "#/components/schemas/PolicyAttributeAdjustment"
        externalIdentifiers:
          $ref: "#/components/schemas/AdhocExternalIdentifiers"
      required:
        - correlationId
        - effectiveDate
        - valueAdjustment
```