Managing fixed property incidents

Overview of the fixed property incident parent

At the parent level, the fixed property incident is an object that captures loss information about a fixed piece of property (such as a building). Cloud API supports the management of fixed property incidents at this parent level, as opposed to working at the child level with either dwelling incidents or other structure incidents.

A fixed property incident typically includes an inline damageable 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 damageables, 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 damageable.

Endpoints for managing fixed property incidents

Use the following endpoints to manage fixed property incidents:

  • GET /claims/{claimId}/fixed-property-incidents
  • POST /claims/{claimId}/fixed-property-incidents
  • GET /claims/{claimId}/fixed-property-incidents/{incidentId}
  • PATCH /claims/{claimId}/fixed-property-incidents/{incidentId}
  • DELETE /claims/{claimId}/fixed-property-incidents/{incidentId}

For example, the following request creates a fixed property incident for claim cc:73. In the request, the inline damageable (the incident's location) is included, and it is created as an inlined resource.

POST /claim/v1/claims/cc:73/fixed-property-incidents

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