Creating incidents

In the base configuration, there are no required fields for creating any type of incident. All fields are optional.

The following sections provide additional information and examples of the various types of incidents you can create through the system APIs.

Dwelling incidents

A dwelling incident is an object that captures loss information about a place where people live.

In the base configuration, dwelling incidents can be used with policies of the following type:

  • HOPHomeowners

A dwelling incident typically includes a primary child object called location, with fields that describe inherent qualities of the dwelling's location, such as address. The dwelling incident also contains additional information specific to the loss, such as damagedAreaSize and severity. You do not have to specify location when you create a dwelling incident. If you do want to specify location, you can either:

  • Specify an existing location on the policy by providing its policySystemId.
  • Specify an existing location on the claim by providing its ClaimCenter id.
  • Create a new location by providing its attributes inline.

Unlike some other child objects, a location cannot be created as a referenced resource in the included section and then specified by refid. A new location must be created as an inlined resources.

Example of creating a typical dwelling incident

In this example, the dwelling incident's location is included, and it is specified by policySystemId.

POST /claims/{claimId}/dwelling-incidents

{
    "data": {
        "attributes": {
            "description": "water from heavy rains leaked through the roof damaging walls and floor.",
            "location" : {
              "policySystemId" : "pcdwl:0001-1"
              } ,
	     "yearsInHome" : 7
        }
    }
}

Fixed property incidents

A fixed property incident is an object that captures loss information about a fixed piece of property (such as a building) or a permanent structure (such as a fence or a fountain).

In the base configuration, fixed property incidents can be used for a large range of policy types. This includes:

  • Business auto
  • Businessowners
  • Commercial package
  • Commercial property
  • Personal auto

This list is not exhaustive. For a complete list of policy types that are compatible with fixed property incidents, refer to the Incident typelist in Studio.

A fixed property incident typically includes a primary child object called location, with fields that describe inherent qualities of the property's location, such as address. The fixed property incident also contains additional information specific to the loss, such as lossparty and severity. You do not have to specify location when you create a fixed property incident. If you do want to specify location, you can either:

  • Specify an existing location on the policy by providing its policySystemId.
  • Specify an existing location on the claim by providing its ClaimCenter id.
  • Create a new location by providing its attributes inline.

Unlike some other child objects, a location cannot be created as a referenced resource in the included section and then specified by refid. A new location must be created as an inlined resources.

Example of creating a typical fixed property incident

In this example, the dwelling incident's location is included, and it is created as an inlined resource.

POST /claims/{claimId}/fixed-property-incidents

{
    "data": {
        "attributes": {
            "location": {
                "address": {
                    "addressLine1": "1313 Monroe Lane",
                    "city": "Pomona",
                    "country": "US",
                    "state": {
                        "code": "CA"
                    }
                },
                "primaryLocation": false
            },
            "severity" : {
              "code" : "major-prop"
            }
        }
    }
}

Injury incidents

An injury incident is an object that captures loss information about a single injury that a claimant suffered.

In the base configuration, injury incidents can be used for a large range of policy types. This includes:

  • Business auto
  • Businessowners
  • Commercial package
  • General liability
  • Personal auto

This list is not exhaustive. For a complete list of policy types that are compatible with fixed property incidents, refer to the Incident typelist in Studio.

An injury incident typically includes a primary child object called injuredPerson, with fields that describe inherent qualities of the person, such as firstName and lastName. The injury incident also contains additional information specific to the injury, such as ambulenceused, primaryDoctor, and treatmentType. You do not have to specify injuredPerson when creating an injury incident. If you do want to specify injuredPerson, you can either:

  • Specify an existing ClaimContact on the policy by providing its policySystemId.
  • Specify an existing ClaimContact on the claim by providing its ClaimCenter id.
  • Create a new ClaimContact in the included section and reference that ClaimContact by refid.

Example of creating a typical injury incident

In this example, the injury incident's injuredPerson is provided, and it is specified by ClaimCenter id.

POST /claims/{claimId}/injury-incidents

{
    "data": {
        "attributes": {
            "bodyParts": [
                {
                    "primaryBodyPart": {
                        "code": "head"
                    }
                }
            ],
            "description": "Potential vision loss",
            "detailedInjuryType": {
                "code": "58"
            },
            "generalInjuryType": {
                "code": "specific"
            },
            "injuredPerson": {
                "id": "cc:102"
            },
            "lossParty": {
                "code": "third_party"
            },
            "lostWages": true,
            "severity": {
                "code": "major-injury"
            },
            "treatmentType": {
                "code": "hospital"
            }
        }
    }
}

Living expenses incidents

A living expenses incident is an object that captures loss information about expenses incurred as a result of the loss of use of a property. (For example, staying in a hotel while a damaged home is repaired.)

In the base configuration, living expenses incidents can be used with policies of the following type:

  • HOPHomeowners

Unlike other types of incidents, a living expense incident does not make use of a primary child object.

Example of creating a typical living expense incident

In this example, a living expense incident is created. There is no primary child object to reference or create.

POST /claims/{claimId}/living-expenses-incidents
        
{
    "data": {
        "attributes": {
            "description": "7-day hotel stay during flood damage repair",
		"lossParty" : {
		  "code" : "insured"
		},
		"startDate" : "2020-08-31T07:00:00.000Z"
        }
    }
}

Vehicle incidents

A vehicle incident is an object that captures loss information about a vehicle.

In the base configuration, vehicle incidents can be used with policies of the following type:

  • Business auto
  • Businessowners
  • Personal auto
  • Personal travel

A vehicle incident typically includes a primary child object called vehicle, with fields that describe inherent qualities of the vehicle, such as make, model, and licenseplate. The vehicle incident also contains additional information specific to the loss, such as airbagsdeployed, collisionpoint, and driver. You do not have to specify vehicle when creating a vehicle incident. If you do want to specify vehicle, you can either:

  • Specify an existing vehicle on the policy by providing its policySystemId.
  • Specify an existing vehicle risk unit on the claim by providing its ClaimCenter id.
  • Create a new vehicle by providing its attributes inline.

Unlike some other child objects, a vehicle cannot be created as a referenced resource in the included section and then specified by refid. A new vehicle must be created as an inlined resources.

Example of creating a typical vehicle incident

In this example, the vehicle incident's vehicle is provided, and it is created as an inlined resource.

POST /claims/{claimId}/vehicle-incidents

{
    "data": {
        "attributes": {
            "collisionPoint": {
                "code": "front"
            },
            "damageDescription": "Damage to bumper and front panels",
            "driver": {
                "id": "cc:102"
            },
            "severity": {
                "code": "moderate-auto"
            },
            "vehicle": {
                "licensePlate": "7FDG745",
                "make": "Mercury",
                "model": "Sable",
                "state": {
                    "code": "CA",
                    "name": "California"
                },
                "vin": "6GYF54637HD645370",
                "year": 1993
            }
        }
    }
}