Manage Accounts

Manage account data using Risk Modeler API services

Overview

An account defines a contract between a buyer (the cedant) and a seller (the underwriter) that transfers risk from the contract buyer to the contract seller in exchange for some premium.

The accounts resource enables clients to create new account objects that encompass the underwriter, branch, producer, and cedant objects. A policy defines the terms of the contract between the cedant and underwriter regarding one or more locations.

Add accounts

The Create a new account resource enables you to create new account objects and add that object to a specific EDM data source. The name of the datasource must be specified as a query in the endpoint. All other parameters are specified in the body of the request.

The request body defines a unique account id, name, number and other fields that enables you to manage the account. You may also use the request to identify the cedants, producers, underwriters, and branches belonging to the account.

curl --location --request POST 'https://{host}/riskmodeler/v2/accounts/?datasource=XXXXXXXXXX' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "branch": {
        "name": "Western Region"
    },
    "cedant": {
        "id": 17,
        "name": "ABC Commerical"
    },
    "number": "1000",
    "underwriter": {
        "name": "McKinnon and Company"
    },
    "name": "DeCeccio",
    "userId1": "Haydon",
    "userId2": "Prideaux",
    "userId3": "Alleline",
    "userId4": "Bland",
    "producer": {
        "id": 38,
        "name": "Risk Consultants, Inc."
    },
    "userText1": "new accounts",
    "userText2": "Mendel"
}'

Depending on your needs the account may include branch, cedant, and underwriter objects:

  • The branch object specifies the name of the branch that underwrites the account. See Branch in the API Reference documentation.
  • The cedant object specifies a risk-holding party (insurer/reinsurer) that is transferring a portion of its risk to another risk-holding party (reinsurer/retrocessionaire). See Cedant in the API Reference documentation.
  • The producer object specifies the name and ID number of an agent or brokerage firm that produced the policy. See Producer in the API Reference documentation.
  • The underwriter object specifies the name of the underwriter. See Underwriter in the API Reference documentation.

The platform returns a 201 status code to indicate that the object was created successfully.

Validate accounts

Before moving on, let’s take a look at the account you just created. The GET /accounts/{id}/validate resource to verify that the account was created as expected.

curl --location --request GET 'https://{host}/riskmodeler/v2/accounts/17/validate?datasource=XXXXXXXX' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXX'

Did this page help you?