Wunderite

Liabilities

On this page, we'll dive into the different liability exposure endpoints you can use to manage them programmatically.

The Liability object

Liability objects represent a single liability exposure in a commercial risk profile. They contain the following properties and relationships:

Commercial-only Properties

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

    The UUID of the premise associated with the liability exposure

  • Name
    class_code
    Type
    nullable string
    Filterable
    Description

    The UUID of the class code associated with the liability exposure

  • Name
    exposure
    Type
    nullable float
    Filterable
    Sortable
    Description

    The amount for the liability exposure. See the premium_base field for expected values.

  • Name
    is_foreign
    Type
    bool
    Filterable
    Sortable
    Description

    Whether the liability exposure is foreign or domestic

  • Name
    premium_base
    Type
    enum
    Filterable
    Sortable
    Description

    The base for the premium calculation

    • Name
      floor_area
      Description

      Floor area, per 1,000 square feet

    • Name
      total_cost
      Description

      Total cost, per $1,000

    • Name
      admissions
      Description

      Admissions, per 1,000

    • Name
      operating_expenses
      Description

      Operating expenses, per $1,000

    • Name
      payroll
      Description

      Payroll, per $1,000

    • Name
      gross_sales
      Description

      Gross Sales, Per $1,000

    • Name
      per_unit
      Description

      Per Unit

    • Name
      other
      Description

      See classification notes

  • Name
    notes
    Type
    nullable string
    Description

    Any additional notes or comments about the liability exposure

Meta

  • Name
    created
    Type
    timestamp
    Filterable
    Sortable
    Description

    An ISO-8601 timestamp (UTC) indicating when the liability exposure was created

  • Name
    updated
    Type
    timestamp
    Filterable
    Sortable
    Description

    An ISO-8601 timestamp (UTC) indicating when the liability exposure was last updated

Commercial-only Relations

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

List all liabilities

This endpoint allows you to retrieve a paginated list of all liability exposures in the corresponding commercial risk profile.

Parameters

See the liability object for a list of all available filters and sorts.

Searchable

You can search for liability exposures by providing a search query in the filter[search] parameter. The search query will be matched against a liability exposure's class code's code or description, or in its premise's description or address.

Request

GET
/api/v1/risks/{risk}/data/liabilities
curl -G https://app.wunderite.com/api/v1/risks/{risk}/data/liabilities \
-H "Authorization: Bearer {token}" \
-d filter[search]=1432 \
-d per_page=50

Response

{
    "data": [
        {
            "object": "liability",
            "uuid": "309035da-4a7e-487a-a3c8-644eb4d9dac7",
            "data": {
                "premise": "ac9c0e80-ad2d-4dfd-b3db-3dc574b947fe",
                "class_code": "689687e0-ff52-11ef-9897-0242c0a87506",
                "exposure": 301400,
                "is_foreign": false,
                "premium_base": "payroll",
                "notes": null
            },
            "meta": {
                "created": "2024-04-23T18:40:18+00:00",
                "updated": "2024-04-23T18:40:18+00:00"
            },
            "relations": {
                "class_code": {
                    "object": "liability_code",
                    "uuid": "689687e0-ff52-11ef-9897-0242c0a87506",
                    "data": {
                        "code": "41675",
                        "description": "Computer Consulting or Programming"
                    }
                },
                "premise": "ac9c0e80-ad2d-4dfd-b3db-3dc574b947fe"
            }
        },
        {
            "object": "liability",
            "uuid": "1c77aed3-d40b-4e0d-955b-1a9abaeb2cf4",
            "data": {
                "premise": "ab4b7842-2446-4fa2-b2ad-045e7ba9b59e",
                "class_code": "689687e0-ff52-11ef-9897-0242c0a87506",
                "exposure": 453200,
                "is_foreign": true,
                "premium_base": "payroll",
                "notes": null
            },
            "meta": {
                "created": "2024-04-23T18:40:18+00:00",
                "updated": "2024-04-23T18:40:18+00:00"
            },
            "relations": {
                "class_code": {
                    "object": "liability_code",
                    "uuid": "689687e0-ff52-11ef-9897-0242c0a87506",
                    "data": {
                        "code": "41675",
                        "description": "Computer Consulting or Programming"
                    }
                },
                "premise": "ab4b7842-2446-4fa2-b2ad-045e7ba9b59e"
            }
        }
    ],
    "path": "https:\/\/app.wunderite.com\/api\/v1\/risks\/d10e34bb-4420-47de-ba9f-42a4a3f34b0e\/data\/liabilities",
    "per_page": 50,
    "next_cursor": null,
    "next_page_url": null,
    "prev_cursor": null,
    "prev_page_url": null
}
POST/api/v1/risks/{risk}/data/liabilities

Create liabilities

This endpoint allows you to create new liability exposures in the corresponding commercial risk profile.

At least one liability object must be provided in the request body.

Required properties

See all available properties in the properties section.

  • Name
    class_code
    Type
    string
    Description

    A class code UUID from the liability class codes endpoint.

  • Name
    premium_base
    Type
    enum
    Description

    The premium base for the liability exposure.

Request

POST
/api/v1/risks/{risk}/data/liabilities
curl -X POST "https://app.wunderite.com/api/v1/risks/{risk}/data/liabilities" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json" \
-d '{
"data": [
    {
        "object": "liability",
        "data": {
            "premise": "ac9c0e80-ad2d-4dfd-b3db-3dc574b947fe",
            "class_code": "689687e0-ff52-11ef-9897-0242c0a87506",
            "exposure": 12345.01,
            "is_foreign": false,
            "premium_base": "per_unit",
            "notes": "Some notes"
        }
    }
]
}'

Response

{
    "data": [
        {
            "object": "liability",
            "uuid": "fdfa0632-7878-4283-8da3-a696bf8898d3",
            "data": {
                "premise": "ac9c0e80-ad2d-4dfd-b3db-3dc574b947fe",
                "class_code": "689687e0-ff52-11ef-9897-0242c0a87506",
                "exposure": 12345.01,
                "is_foreign": false,
                "premium_base": "per_unit",
                "notes": "Some notes"
            },
            "meta": {
                "created": "2024-01-01T00:00:00+00:00",
                "updated": "2024-01-01T00:00:00+00:00"
            },
            "relations": {
                "class_code": {
                    "object": "liability_code",
                    "uuid": "689687e0-ff52-11ef-9897-0242c0a87506",
                    "data": {
                        "code": "41675",
                        "description": "Computer Consulting or Programming"
                    }
                },
                "premise": "ac9c0e80-ad2d-4dfd-b3db-3dc574b947fe"
            }
        }
    ]
}
PATCH/api/v1/risks/{risk}/data

Update liabilities

This endpoint allows you to perform bulk updates on liability exposures.

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

Properties that are not provided will not be updated.

To clear a nullable property, provide a null value.

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" \
-d '{
"data": [
    {
        "object": "liability",
        "uuid": "309035da-4a7e-487a-a3c8-644eb4d9dac7",
        "data": {
            "premise": "ac9c0e80-ad2d-4dfd-b3db-3dc574b947fe",
            "class_code": "689687e0-ff52-11ef-9897-0242c0a87506",
            "exposure": 301400,
            "is_foreign": false,
            "premium_base": "payroll",
            "notes": null
        }
    }
]
}'

Response

{
    "data": [
        {
            "object": "liability",
            "uuid": "309035da-4a7e-487a-a3c8-644eb4d9dac7",
            "data": {
                "premise": "ac9c0e80-ad2d-4dfd-b3db-3dc574b947fe",
                "class_code": "689687e0-ff52-11ef-9897-0242c0a87506",
                "exposure": 301400,
                "is_foreign": false,
                "premium_base": "payroll",
                "notes": null
            },
            "profile_type": "commercial"
        }
    ]
}
DELETE/api/v1/risks/{risk}/data

Delete liabilities

This endpoint allows you to bulk delete risk data, including liability exposures.

At least one liability object must be provided in the request body to delete the corresponding exposure.

Required properties

  • Name
    object
    Type
    string
    Description

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

  • Name
    uuid
    Type
    string
    Description

    The UUID of the liability exposure 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" \
-d '{
"data": [
    {
        "object": "liability",
        "uuid": "309035da-4a7e-487a-a3c8-644eb4d9dac7"
    }
]
}'

Response

{
    "data": [
        {
            "object": "liability",
            "uuid": "309035da-4a7e-487a-a3c8-644eb4d9dac7",
            "profile_type": "commercial"
        }
    ]
}