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

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

# FaceAmountChangeRequest

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Policy Service
  version: 0.0.21
servers:
  - url: https://qa.api.zinnia.io
components:
  schemas:
    FaceAmountTransactionReason:
      type: string
      description: Business reason for the face amount change (must match supported
        DAML mapping).
      enum:
        - FACEDECREASECOVERAGE
        - FACEINCREASECOVERAGE
    FaceAmountChangeTransactionAmounts:
      type: object
      properties:
        requestedAmount:
          type: number
          example: 250000
          format: double
          description: Requested face amount for the covered contract or rider.
      required:
        - requestedAmount
    FaceAmountChangeValueAdjustment:
      type: object
      properties:
        coverageId:
          type: string
          example: Base_Coverage
          description: Identifier of the coverage row being adjusted.
        coverageType:
          $ref: "#/components/schemas/CoverageType"
      required:
        - coverageId
        - coverageType
    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
    CoverageType:
      type: string
      description: Coverage indicator sent to the ledger as the Java `IndicatorCode`
        enum name (string form). Must be one of the supported indicator codes
        for the contract row being adjusted.
      enum:
        - BASE
        - RIDER
        - BASEINCREASE
        - INTEGRATEDRIDER
        - RIDERINCREASE
        - BENEFIT
        - DISCOUNT
        - UNKNOWN
        - OTHER
    FaceAmountChangeRequest:
      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.
        transactionReason:
          $ref: "#/components/schemas/FaceAmountTransactionReason"
        transactionAmounts:
          $ref: "#/components/schemas/FaceAmountChangeTransactionAmounts"
        valueAdjustment:
          $ref: "#/components/schemas/FaceAmountChangeValueAdjustment"
        externalIdentifiers:
          $ref: "#/components/schemas/AdhocExternalIdentifiers"
      required:
        - correlationId
        - effectiveDate
        - transactionReason
        - transactionAmounts
        - valueAdjustment
```