Reinsurance risks

Reinsurance is insurance for insurance companies. A direct policy insurer will bundle risk coverages in a way that allows them to share those risks with other insurers. Those shared risks can be described as reinsurance risks, or reinsurables. For a complete description and details of reinsurance, see the Application Guide .

The following endpoints retrieve the reinsurance risks that are associated with a job or policy:

  • GET /job/v1/jobs/{jobId}/reinsurables
  • GET /job/v1/jobs/{jobId}/reinsurables/{reinsurableId}
  • GET /policy/v1/policies/{policyId}/reinsurables
  • GET /policy/v1/policies/{policyId}/reinsurables/{reinsurabldId}

Reinsurables details

Applicable reinsurance risks are automatically attached to the job (and by extension the policy) when the job is quoted. Therefore, there are no endpoints that create or update reinsurables on policies and jobs; it’s an automatic process.

Because reinsurables are assigned when a job is quoted, if a job is in Draft mode the reinsurables endpoints will return an empty data set for that job.

The base configuration comes with two types of reinsurables, policyRisk and locationRisk. (A policy risk reinsurable is any risk associated with the policy other than location. A location risk reinsurable is associated with a specific location, such as the home in a homeowners policy.)

Keep in mind that the reinsurables returned in the responses to these endpoints are reinsurance risks that are capable of being reinsured; they haven’t necessarily been reinsured. To determine whether a particular reinsurable has been reinsured, check the riskNumber property in the response:

"riskNumber": "100"

If the riskNumber contains a value (as it does here), the reinsurable is reinsured. If the riskNumber is null, the reinsurable is capable of being reinsured, but has not yet been reinsured.

Examples

The following examples demonstrate how to retrieve reinsurables for a policy and a job, respectively. Both the policy and job have a Workers’ Comp coverage reinsurable.

Command

GET /policy/v1/policies/pc:100/reinsurables

Response

{
    "data": [
        {
            "attributes": {
                "displayName": "Policy-level",
                "id": "101",
                "reinsuranceCurrency": {
                    "code": "usd",
                    "name": "USD"
                },
                "riCoverageGroupType": {
                    "code": "WorkersComp",
                    "name": "Workers Comp"
                },
                "riskNumber": "100"
            },

Command

GET /job/v1/jobs/pc:500/reinsurables

Response

{
    "data": [
        {
            "attributes": {
                "displayName": "Policy-level",
                "id": "101",
                "reinsuranceCurrency": {
                    "code": "usd",
                    "name": "USD"
                },
                "riCoverageGroupType": {
                    "code": "WorkersComp",
                    "name": "Workers Comp"
                },
                "riskNumber": "100"
            },

This example retrieves reinsurables for policy pc:101, which has an Auto Liability coverage reinsurable with a Total Insured Value of $600,000 USD:

Command

GET /policy/v1/policies/pc:101/reinsurables

Response

{
    "data": [
        {
            "attributes": {
                "displayName": "Policy-level",
                "id": "2",
                "reinsuranceCurrency": {
                    "code": "usd",
                    "name": "USD"
                },
                "riCoverageGroupType": {
                    "code": "AutoLiability",
                    "name": "Auto Liability"
                },
                "riskNumber": "1",
                "totalInsuredValue": {
                    "amount": "600000.00",
                    "currency": "usd"
                }
            },