Assigning claims

When a claim completes the FNOL process (either through the user interface or through the /submit endpoint), it is assigned to a group and a user in that group. The assigned user has the primary responsible for managing the claim.

When you submit a claim through the system APIs, ClaimCenter automatically executes the claim assignment rules to initially assign the claim to a group and user. You can use the POST /claims/{claimId}/assign endpoint to reassign the claim as needed.

Note: The functionality for assigning claims is a subset of the functionality for assigning activities. All assignment options that are applicable to both activities and claims have the same behavior.

Assignment options

A claim can be assigned through the system APIs in the following ways:

  • To a specific group and user in that group
  • To a specific group only (and then ClaimCenter uses assignment rules to select a user in that group)
  • By re-running the claim assignment rules
    • This can be appropriate if you have modified the claim since the last time assignment rules were run and the modification might affect who the claim would be assigned to.

The root resources for the /claims/{claimId}/assign endpoints is ClaimAssignee. This resource specifies assignment criteria. The schema has the following fields:

Field Type Description
autoAssign Boolean Whether to assign the claim using assignment rules
groupId string The ID of the group to assign the claim to
userId string The ID of the user to assign the claim to

The ClaimAssignee resource cannot be empty. It must specify a single logical assignment option (group and user, group only, or automatic assignment). For more information on how assignment rules execute assignment, see the Gosu Rules Guide.

Assignment example - Assigning to a specific group (and user)

The following assigns claim cc:34 to group demo_sample:31 (Auto1 - TeamA) and user demo_sample:2 (Sue Smith).

POST /claim/v1/claims/cc:34/assign

{
  "data": {
    "attributes" : {
      "groupId" : "demo_sample:31",
      "userId" : "demo_sample:2"
    }
  }
}

The following assigns claim cc:34 to group demo_sample:31 (Auto1 - TeamA). Because no user has been specified, ClaimCenter will execute assignment rules to assign the claim to a user in group demo-sample:31.

POST /claim/v1/claims/cc:34/assign

{
  "data": {
    "attributes" : {
      "groupId" : "demo_sample:31"
    }
  }
}

Note that there is currently no endpoint that returns groups or group IDs. To assign claims to a specific group, the caller application must determine the group ID using some method other than a groups system API.

Assignment example - Using automated assignment

The following assigns claim cc:34 using automated assignment rules.

POST /claim/v1/claims/cc:34/assign

{
  "data": {
    "attributes": {
        "autoAssign" : true
    }
  }
}