Wunderite

Subjects of Insurance

Subjects of Insurance refer to the specific assets or items associated with each Building to be insured. The endpoint will allow you to add the individual risk coverages and amounts for each Building.

The subject of insurance object

The Subject of Insurance objects represent the individual coverages and amounts to be insured on each Building. These objects are optional and a Building may have one or many Subjects of Insurance. They contain the following properties and relationships:

Commercial-only Properties

These properties are available only for commercial risk profiles.
  • Name
    building
    Type
    string
    Filterable
    Description

    The UUID of the building this subject of insurance belongs to

  • Name
    type
    Type
    enum
    Filterable
    Sortable
    Description

    The type of the subject of insurance

  • Name
    amount
    Type
    int
    Filterable
    Sortable
    Description

    The dollar amount of the subject of insurance, in cents

  • Name
    display_value
    Type
    nullable string
    Filterable
    Sortable
    Description

    The custom display value when type is other

  • Name
    coinsurance_percent
    Type
    nullable int
    Filterable
    Sortable
    Description

    Coinsurance percentage (0-100)

  • Name
    valuation
    Type
    nullable string
    Filterable
    Sortable
    Description

    Valuation type (e.g. Replacement Cost, Actual Cash Value)

  • Name
    cause_of_loss
    Type
    nullable string
    Filterable
    Sortable
    Description

    Cause of loss coverage (e.g. Fire, Flood)

  • Name
    inflation_guard
    Type
    nullable int
    Filterable
    Sortable
    Description

    Inflation guard percentage (0-100)

  • Name
    deductible
    Type
    nullable int
    Filterable
    Sortable
    Description

    Deductible dollar amount, in cents

  • Name
    deductible_type
    Type
    nullable string
    Filterable
    Sortable
    Description

    Type of deductible (e.g. Per Occurrence, Per Claim)

  • Name
    forms_and_conditions
    Type
    nullable string
    Filterable
    Sortable
    Description

    Additional forms and conditions text

Meta

  • Name
    created
    Type
    timestamp
    Filterable
    Sortable
    Description

    An ISO-8601 timestamp (UTC) indicating when the subject of insurance was created

  • Name
    updated
    Type
    timestamp
    Filterable
    Sortable
    Description

    An ISO-8601 timestamp (UTC) indicating when the subject of insurance was last updated

Commercial-only Relations

Learn more about including relations.
GET/api/v1/risks/{risk}/data/subjects_of_insurance

List subjects of insurance

This endpoint allows you to retrieve a paginated list of subjects of insurance by building.

Required parameters

  • Name
    filter[building]
    Type
    string|string[]
    Description

    The UUID(s) of the building to filter the subjects of insurance by. Multiple UUIDs can be specified either as a comma-separated list or as an array.

    This parameter is not required if a filter[search] parameter has been provided.

Optional parameters

See the subject of insurance model for a list of all available filters and sorts.

Searchable

You can search for subjects of insurance by providing a search query in the filter[search] parameter. The search query will be matched against a subject of insurance's type, or its building's number or description.

Request

GET
/api/v1/risks/{risk}/data/subjects_of_insurance
curl -X GET -G "https://app.wunderite.com/api/v1/risks/{risk}/data/subjects_of_insurance?filter[building]=cd4c8998-430a-4f43-a48d-87f631eab1fb" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json"

Response

{
    "data": [
        {
            "object": "subject_of_insurance",
            "uuid": "b8c9bb26-f08f-4958-bb51-a5cc1c4a85bf",
            "data": {
                "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb",
                "type": "bpp",
                "amount": 87243100,
                "display_value": null,
                "coinsurance_percent": null,
                "valuation": null,
                "cause_of_loss": null,
                "inflation_guard": null,
                "deductible": null,
                "deductible_type": null,
                "forms_and_conditions": null
            },
            "meta": {
                "created": "2024-04-19T13:08:27+00:00",
                "updated": "2024-04-19T13:08:27+00:00"
            },
            "relations": {
                "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb"
            }
        },
        {
            "object": "subject_of_insurance",
            "uuid": "712b3a68-3614-49fd-932a-bfd6220a17a9",
            "data": {
                "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb",
                "type": "b",
                "amount": 94376200,
                "display_value": null,
                "coinsurance_percent": null,
                "valuation": null,
                "cause_of_loss": null,
                "inflation_guard": null,
                "deductible": null,
                "deductible_type": null,
                "forms_and_conditions": null
            },
            "meta": {
                "created": "2024-04-19T13:08:27+00:00",
                "updated": "2024-04-19T13:08:27+00:00"
            },
            "relations": {
                "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb"
            }
        }
    ],
    "path": "https:\/\/app.wunderite.com\/api\/v1\/risks\/d10e34bb-4420-47de-ba9f-42a4a3f34b0e\/data\/subjects_of_insurance",
    "per_page": 50,
    "next_cursor": null,
    "next_page_url": null,
    "prev_cursor": null,
    "prev_page_url": null
}
POST/api/v1/risks/{risk}/data/subjects_of_insurance

Create subjects of insurance

This endpoint allows you to upload a new attachment to a conversation. See the code examples for how to send the file to the Protocol API.

Required attributes

  • Name
    building
    Type
    string
    Description

    The UUID of the building that the subject of insurance should be associated with

  • Name
    type
    Type
    enum
    Description

    The type of the subject of insurance

  • Name
    amount
    Type
    integer
    Description

    The amount of the subject of insurance, in cents

Optional attributes

See all available properties in the properties section.

  • Name
    display_value
    Type
    string
    Description

    A human-readable display value for the subject of insurance, when type is other

Request

POST
/api/v1/risks/{risk}/data/subjects_of_insurance
curl -X POST "https://app.wunderite.com/api/v1/risks/{risk}/data/subjects_of_insurance" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \ 
-d '{
"data": [
    {
        "object": "subject_of_insurance",
        "data": {
            "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb",
            "type": "b",
            "amount": 1000000,
            "coinsurance_percent": 80,
            "valuation": "Replacement Cost",
            "cause_of_loss": "Hail",
            "inflation_guard": 5,
            "deductible": 250000,
            "deductible_type": "Per Claim",
            "forms_and_conditions": "Standard commercial property coverage terms and conditions apply."
        }
    }
]
}'

Response

{
    "data": [
        {
            "object": "subject_of_insurance",
            "uuid": "71e00afe-17ee-4ac5-9def-df1f4aa1e083",
            "data": {
                "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb",
                "type": "b",
                "amount": 1000000,
                "display_value": null,
                "coinsurance_percent": 80,
                "valuation": "Replacement Cost",
                "cause_of_loss": "Hail",
                "inflation_guard": 5,
                "deductible": 250000,
                "deductible_type": "Per Claim",
                "forms_and_conditions": "Standard commercial property coverage terms and conditions apply."
            },
            "meta": {
                "created": "2024-01-01T00:00:00+00:00",
                "updated": "2024-01-01T00:00:00+00:00"
            },
            "relations": {
                "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb"
            }
        }
    ]
}
PATCH/api/v1/risks/{risk}/data

Update subjects of insurance

This endpoint allows you to perform bulk updates on subjects of insurance.

At least one subject of insurance object must be provided in the request body. Each object must contain at least one property from the subject of insurance properties section.

Properties that are not provided will not be updated.

Notes

When providing a type property of other (see the type enum), the display_value property will default to Other if none is supplied.

Request

PATCH
/api/v1/risks/{risk}/data
curl -X PATCH "https://app.wunderite.com/api/v1/risks/{risk}/data" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \ 
-d '{
"data": [
    {
        "object": "subject_of_insurance",
        "uuid": "b8c9bb26-f08f-4958-bb51-a5cc1c4a85bf",
        "data": {
            "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb",
            "type": "bpp",
            "amount": 87243100,
            "display_value": null,
            "coinsurance_percent": null,
            "valuation": null,
            "cause_of_loss": null,
            "inflation_guard": null,
            "deductible": null,
            "deductible_type": null,
            "forms_and_conditions": null
        }
    }
]
}'

Response

{
    "data": [
        {
            "object": "subject_of_insurance",
            "uuid": "b8c9bb26-f08f-4958-bb51-a5cc1c4a85bf",
            "data": {
                "building": "cd4c8998-430a-4f43-a48d-87f631eab1fb",
                "type": "bpp",
                "amount": 87243100,
                "display_value": null,
                "coinsurance_percent": null,
                "valuation": null,
                "cause_of_loss": null,
                "inflation_guard": null,
                "deductible": null,
                "deductible_type": null,
                "forms_and_conditions": null
            },
            "profile_type": "commercial"
        }
    ]
}
DELETE/api/v1/risks/{risk}/data

Delete subjects of insurance

This endpoint allows you to bulk delete risk data, including subjects of insurance.

At least one subject of insurance object must be provided in the request body to delete the corresponding subject of insurance.

Required properties

  • Name
    object
    Type
    string
    Description

    The object type of the data to delete. Must be subject_of_insurance in this case.

  • Name
    uuid
    Type
    string
    Description

    The UUID of the subject of insurance to delete

Request

DELETE
/api/v1/risks/{risk}/data
curl -X DELETE "https://app.wunderite.com/api/v1/risks/{risk}/data" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \ 
-d '{
"data": [
    {
        "object": "subject_of_insurance",
        "uuid": "b8c9bb26-f08f-4958-bb51-a5cc1c4a85bf"
    }
]
}'

Response

{
    "data": [
        {
            "object": "subject_of_insurance",
            "uuid": "b8c9bb26-f08f-4958-bb51-a5cc1c4a85bf",
            "profile_type": "commercial"
        }
    ]
}