---
title: "Submit interim status update"
url: "https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e/operations/submitInterimStatusUpdate"
---

> Full API specification: https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e.md

# Submit interim status update

`POST` `/bpm/newbusiness/v1/interim-status-update`

Operation ID: `submitInterimStatusUpdate`

## Request body (required)

Content types: `application/json`

## Responses

- `201` - Case Created
- `400` - Bad request
- `401` - Authentication failed
- `403` - Access denied
- `500` - Server error

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business API.
  version: 0.9.8
servers:
  - url: https://qa.api.zinnia.io
    description: QA Environment
  - url: https://dev.api.zinnia.io
    description: DEV Environment
  - url: https://uat.api.zinnia.io
    description: UAT Environment
  - url: https://api.zinnia.io
    description: PROD Environment
paths:
  /bpm/newbusiness/v1/interim-status-update:
    post:
      x-internal: true
      tags:
        - New Business Transactions V1
      summary: Submit interim status update
      operationId: submitInterimStatusUpdate
      requestBody:
        description: Details required to submit interim status to PG
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/InterimStatusUpdateRequest"
        required: true
      responses:
        "201":
          description: Case Created
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SuccessResponse"
        "400":
          description: Bad request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ValidationResponse"
        "401":
          description: Authentication failed
        "403":
          description: Access denied
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AccessDeniedResponse"
        "500":
          description: Server error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ServerErrorResponse"
      security:
        - Auth0: []
security:
  - Auth0: []
components:
  schemas:
    InterimStatusUpdateRequest:
      type: object
      properties:
        eappId:
          type: string
          description: Unique application Id generated by the UI. Each application would
            have unique identifier
          example: 15ea7582-262f-4dfe-8a60-1e8b8e763fd4
        caseId:
          type: string
          description: Zinnia Live case
          example: CA0000005656
        policyNumber:
          type: string
          description: Policy Number
          example: AB00000001
        uwCaseId:
          type: string
          description: Underwriter caseId
          example: UW0000005656
        carrier:
          type: string
          description: Client Code
          example: CL0000001
        policyStatus:
          type: string
          description: Status of Policy
          example: Policy Status
        underwriting:
          allOf:
            - $ref: "#/components/schemas/Underwriting"
            - type: object
              properties:
                instantIdDecision:
                  type: string
                  description: InstantId decision
      required:
        - eappId
        - caseId
    SuccessResponse:
      type: object
      properties:
        statusCode:
          type: integer
          format: int32
          example: 201
        timestamp:
          type: string
          format: date-time
        message:
          type: string
          example: Request Submitted Successfully
    ValidationResponse:
      type: object
      properties:
        status:
          type: string
          example: FAILED
        timestamp:
          type: string
          format: date-time
        message:
          type: string
          example: Bad Request
        error:
          type: array
          items:
            type: string
            example: Mandatory attribute label missing
    AccessDeniedResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        message:
          type: string
          example: "User is not authorized for the carrier : CarrierName_1"
    ServerErrorResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        message:
          type: string
          example: Failed to process request
    Underwriting:
      type: object
      properties:
        decision:
          type: string
          enum:
            - Approved
            - Pending Decision
            - Pending Review
            - Declined
            - Risk Not Acceptable
          description: Underwriting decision
        totalReplacementCoverageAmt:
          type: number
          description: Total replacement coverage amount
          example: 250000
        status:
          type: string
          enum:
            - CLEAN_CASE
            - DECLINED
            - MODIFIED
            - ADVERSE
            - N/A
          description: Status of UW case
        issuedAsAppliedInd:
          type: string
          enum:
            - Yes
            - No
            - Unknown
          description: Indicator flag to specify as no change
        underwritingRiskClass:
          type: string
          enum:
            - Elite Non-Tobacco
            - Preferred Non-Tobacco
            - Standard Non-Tobacco
            - Standard Tobacco
            - Standard Aggregate
            - Substandard Non-Tobacco
            - Substandard Tobacco
          description: Risk Class Configured at Underwriting System.
          example: Elite Non-Tobacco
        decisionRiskClass:
          type: string
          enum:
            - Elite Non-Tobacco
            - Preferred Non-Tobacco
            - Standard Non-Tobacco
            - Standard Tobacco
            - Standard Aggregate
            - Substandard Non-Tobacco
            - Substandard Tobacco
          description: Decision Risk Class
          example: Elite Non-Tobacco
        underwritingMethod:
          type: string
          enum:
            - FULL_UNDERWRITING
            - ATTESTATION_VALIDATION
            - ADDITIONAL_UNDERWRITING
            - SIMPLIFIED_UNDERWRITING
            - REDUCED_UNDERWRITING
          description: Underwriting methods
        tobaccoPremiumBasis:
          type: string
          enum:
            - Smoker
            - Non-Smoker
          description: Premium basis
        tableRating:
          type: string
          enum:
            - A
            - B
            - C
            - D
            - E
            - F
            - G
            - H
          description: Table rating from Underwriting System.
          example: A
        permFlatExtraAmt:
          type: number
          description: Extra Amount
          example: 250000
        tempFlatExtraAmt:
          type: number
          description: Temporary extra amount
          example: 250000
        flatExtrasDuration:
          type: number
          description: extra duration
          example: 250000
        approvedFaceAmount:
          type: number
          description: Approved Face Amount
          example: 250000
        approvedMaxFaceAmount:
          type: number
          description: Approved Maximum Face Amount
          example: 250000
        UnderwritingResult:
          type: array
          items:
            $ref: "#/components/schemas/UnderwritingResult"
    UnderwritingResult:
      type: object
      properties:
        description:
          type: string
          description: Result description
          example: Scuba diving deeper than 130 feet
        reasonCode:
          type: string
          enum:
            - App
            - MM
            - LN
            - Exam One
            - MIB
            - EIS
          description: Reason code
          example: LN
  securitySchemes:
    Auth0:
      type: openIdConnect
      openIdConnectUrl: https://login.dev.zinnia.com/.well-known/openid-configuration
      x-kong-security-openid-connect:
        config:
          run_on_preflight: true
          scopes_claim:
            - https://dev.api.zinnia.io/permissions
          audience_claim:
            - aud
          audience_required:
            - https://dev.api.zinnia.io
          client_id:
            - client_id
          auth_methods:
            - bearer
        enabled: true
        protocols:
          - grpc
          - grpcs
          - http
          - https
```