Creating assessment summaries

Use the following endpoint to create an assessment summary for a claim or exposure:

  • POST /claim/v1/claims/{claimId}/assessment-summaries

Required fields

The following fields are required to create an assessment summary for a claim:

  • category: This string represents the category of the risk score. For example, a fraud system might use values like low_risk and high_risk, and a total loss evaluation system might use values like repairable and total_loss.
  • scoreDate: This date-time is the date and time that the external system scored the claim or exposure.
  • tapId: This string represents the ID of the third party assessment provider.
  • tapSubtypeId: This string identifies the type of assessment, such as fraud.

Typically, these values are provided by an external analytics service, so you would want to set up a system that takes those values and uses them to create assessment summary records for their associated claims and exposures in ClaimCenter.

Create a minimal assessment summary

The following request includes only the minimum required fields to create an assessment summary for a claim:

Command

POST /claim/v1/claims/demo_sample:1/assessment-summaries

Request

{
  "data": {
    "attributes": {
      "category": "medium_risk",
      "scoreDate": "2024-11-14T15:42:24Z",
      "tapId": "ClaimSegmentationV1",
      "tapSubtypeId": "fraud"
    }
  }
}

Response

{
    "data": {
        "attributes": {
            "category": "medium_risk",
            "id": "xc:S6obf6QD-kx92qkg-c7Wu",
            "scoreDate": "2024-11-14T15:42:24.000Z",
            "tapId": "ClaimSegmentationV1",
            "tapSubtypeId": "fraud"
        }
    }
}

When the request is successful, the API responds with the created assessment summary.

Create a typical assessment summary

A typical assessment summary would often include more details, such as the actual risk score, a description of the conclusion, and recommended actions. For more information about the other details you can include in an assessment summary, as well as how to extend the AssessmentSummary entity, refer to the Application Guide.

The following request creates a typical assessment summary:

Command

POST /claim/v1/claims/demo_sample:1/assessment-summaries

Request

{
  "data": {
    "attributes": {
      "category": "low_risk",
      "scoreDate": "2025-10-14T15:42:24Z",
      "tapId": "ClaimSegmentationV1",
      "tapSubtypeId": "fraud",

      "score": "0.11",
      "normalizedScore": "11",
      "scorePercentile": "10",

      "conclusionCode": "fraud_low",
      "conclusionDescription": "Low likelihood of fraud on this claim",

      "recommendedActionCode": "no_special_action",
      "recommendedActionDescription": "Process the claim using standard procedures",
      "recommendedValue": null,

      "estimate": null,
      "rawAssessmentReferenceId": "am-claim-assessment-98765",
      "name": "Fraud Risk – Day 0"
    }
  }
}

Response

{
    "data": {
        "attributes": {
            "category": "low_risk",
            "conclusionCode": "fraud_low",
            "conclusionDescription": "Low likelihood of fraud on this claim",
            "id": "xc:SNHuQ_BdQLU0iHEA3Eb79",
            "name": "Fraud Risk – Day 0",
            "normalizedScore": "11.0000",
            "rawAssessmentReferenceId": "am-claim-assessment-98765",
            "recommendedActionCode": "no_special_action",
            "recommendedActionDescription": "Process the claim using standard procedures",
            "score": "0.1100",
            "scoreDate": "2025-10-14T15:42:24.000Z",
            "scorePercentile": "10.0000",
            "tapId": "ClaimSegmentationV1",
            "tapSubtypeId": "fraud"
        }
    }
}

Creating assessment summaries for exposures

You can assign an assessment summary to a specific exposure for a claim. To do so, you must include an exposure object with the exposure's id in your request. If you don't know the exposure's id, you can learn how to query for it in Querying for and modifying exposures.

The following request creates an assessment summary for an exposure:

Command

POST /claim/v1/claims/demo_sample:1/assessment-summaries

Request

{
  "data": {
    "attributes": {
      "category": "low_risk",
      "scoreDate": "2026-03-04T15:42:24Z",
      "tapId": "ClaimSegmentationV1",
      "tapSubtypeId": "fraud",

      "exposure": {
        "id": "demo_sample:10001"
      },

      "score": "0.10",
      "normalizedScore": "10",
      "conclusionDescription": "Low likelihood of fraud for this exposure",
      "recommendedActionCode": "no_special_action",
      "recommendedActionDescription": "Handle exposure using standard procedures"
    }
  }
}

Response

{
    "data": {
        "attributes": {
            "category": "low_risk",
            "conclusionDescription": "Low likelihood of fraud for this exposure",
            "exposure": {
                "displayName": "(1) 1st Party Vehicle - Ray Newton",
                "id": "demo_sample:10001",
                "type": "Exposure",
                "uri": "/claim/v1/claims/demo_sample:1/exposures/demo_sample:10001"
            },
            "id": "xc:SfqxPTpRwpc_BAflHJOxi",
            "normalizedScore": "10.0000",
            "recommendedActionCode": "no_special_action",
            "recommendedActionDescription": "Handle exposure using standard procedures",
            "score": "0.1000",
            "scoreDate": "2026-03-04T15:42:24.000Z",
            "tapId": "ClaimSegmentationV1",
            "tapSubtypeId": "fraud"
        }
    }
}