Additional exposure endpoints

The system APIs provide additional endpoints to interact with exposures.

Deleting draft exposures

During the FNOL process, the claim passes through two states: draft and open.

  • A draft claim is a claim that has been saved to the ClaimCenter database, but there is not yet enough information for the claim to enter the adjudication process. Draft claims are not assigned to any user.
  • An open claim is a claim that has been saved to the ClaimCenter database with enough information to enter the adjudication process. Once a claim becomes open, it is assigned to an adjuster.

A draft exposure is an exposure on a draft claim. While a claim is in a draft state, you can delete any exposures created on the claim using the DELETE /claims/{claimId}/exposures/{exposureId} endpoint.

Executing a POST /claims/{claimId}/submit on a draft claim promotes the claim and all of its exposures to open status. Once a claim has been submitted, you can no longer delete its exposures.

Validating exposures

Similar to claim validation, the POST /claim/{claimId}/exposures/{exposureId}/validate endpoint returns allvalidation levels reached for the given exposure. It can also be used to determine what conditions must be met for the exposure to advance to a given validation level.

Checking an exposure's validation level can be useful in the following situations:

  • You want to determine whether the exposure has enough information to be assigned to an adjuster. You can use the /validate endpoint to determine if the exposure has reached the "new loss completion" level. If the exposure is below the "new loss completion" level, the payload identifies the conditions needed to reach "new loss completion".
  • You want to execute a payment for an exposure. You can use the /validate endpoint to determine if the exposure has reached the "ability to pay" level, as well as all levels before “ability to pay”. If the exposure is below the "ability to pay" level, the payload identifies the conditions needed to reach "ability to pay".
  • Your instance of ClaimCenter has custom validation levels. You can use the /validate endpoint to determine all the levels the exposure has reached in its lifecycle, including those custom levels.

For more information on validation through system APIs, see Validating claims.

Closing exposures

During an exposure's life cycle, the exposure's status typically moves from draft to open to closed. An exposure is closed to indicate that no further payments are expected to be made from the exposure.

In the base configuration, ClaimCenter automatically closes an exposure when a "final payment" is made from the exposure's reserve line. (A "final payment" is a payment whose payment type is final, as opposed to a payment whose type is partial.) You can also close exposures through Cloud API.

Similar to a closed claim, a closed exposure can be reopened.

Closing exposures

Use the following endpoint to close an exposure:

  • POST /claim/v1/claims/{claimId}/exposures/{exposureId}/close

A request body is not required, but you can include it to specify a closedOutcome, which must be set to a value from the ExposureClosedOutcomeType typelist (such as completed or duplicate).

For example, the following request closes exposure cc:222 on claim cc:706 with a closed outcome of duplicate.

POST /claim/v1/claims/cc:706/exposures/cc:222/close

{
  "data": {
    "attributes": {
      "closedOutcome": {
        "code": "duplicate"
      }
    }
  }
}
Be aware that validation rules can prevent the closing of the exposure. For example, in the base configuration, an exposure cannot be closed if it has open activities. If you attempt to close an exposure with open activities, ClaimCenter responds with a message similar to the following.
"message": "There are open activities related to this exposure. To close the exposure, you must 
first complete or skip these open activities. Please complete or skip these activities before 
closing the exposure.",

Reopening a closed exposure

Use the following endpoint to reopen a closed exposure:

  • POST /claim/v1/claims/{claimId}/exposures/{exposureId}/reopen

A request body is not required, but you can include it to specify either of the following:

  • A note, which is a string value to explain why the exposure has been reopened
  • A reason, which must be set to a value from the ExposureReopenedReason typelist (such as mistake or paymentdenied).

For example, the following request reopens exposure cc:222 on claim cc:706 (assuming the exposure is closed):

POST /claim/v1/claims/cc:706/exposures/cc:222/reopen

<no request body>