Sample payload addendum

This section contains sample payloads referenced in previous topics that are too long to include within those topics.

Sample policy payload

The following payload creates a sample Test Util policy.

{
  "data": {
    "attributes": {
      "effectiveDate": "2020-01-01T07:00:00.000Z",
      "expirationDate": "2031-01-01T07:00:00.000Z",
      "policyNumber": "FNOL-POLICY",
      "verifiedPolicy": true,
      "policyType": {
        "code": "PersonalAuto"
      },
      "status": {
        "code": "inforce"
      },
      "policyContacts": [
        {
          "contact": {
            "refid": "rayNewton"
          },
          "roles": [
            {
              "code": "insured"
            }
          ]
        }
      ],
      "policyLocations": [
        {
          "address": {
            "addressLine1": "287 Kensington Rd. #1A",
            "city": "South Pasadena",
            "postalCode": "91145",
            "state": {
              "code": "CA"
            }
          }
        }
      ],
      "policyCoverages": [
        {
          "coverageType": {
            "code": "PALiabilityCov"
          },
          "incidentLimit": {
            "amount": "30000.00",
            "currency": "usd"
          },
          "exposureLimit": {
            "amount": "15000.00",
            "currency": "usd"
          }
        }
      ],
      "vehicleRiskUnits": [
        {
          "RUNumber": 1,
          "vehicle": {
            "licensePlate": "1HGJ465",
            "make": "Toyota",
            "model": "Prius",
            "policySystemId": "pcveh:0001-1",
            "state": {
              "code": "CA"
            },
            "vin": "1GV234TV347463345",
            "year": 2007
          },
          "coverages": [
            {
              "coverageType": {
                "code": "PACollisionCov"
              },
              "covTerms": [
                {
                  "covTermPattern": {
                    "code": "PACollDeductible"
                  },
                  "covTermSubtype": "FinancialCovTerm",
                  "financialAmount": {
                    "amount": "500.00",
                    "currency": "usd"
                  }
                }
              ],
              "incidentLimit": {
                "amount": "15000.00",
                "currency": "usd"
              }
            }
          ]
        }
      ]
    }
  },
  "included": {
    "TestUtilContact": [
      {
        "attributes": {
          "firstName": "Ray",
          "lastName": "Newton",
          "primaryAddress": {
            "addressLine1": "287 Kensington Rd. #1A",
            "city": "South Pasadena",
            "country": "US",
            "postalCode": "91145",
            "state": {
              "code": "CA"
            }
          },
          "subtype": {
            "code": "Person"
          },
          "policySystemId": "ab:0001-1"
        },
        "method": "post",
        "refid": "rayNewton",
        "uri": "/test-util/v1/contacts"
      }
    ]
  }
}

Sample draft claim payload

The following payload creates a sample draft claim using an existing policy.

{
  "data": {
      "attributes": {
        "lossDate": "2020-03-01T07:00:00.000Z",
        "policyNumber": "FNOL-POLICY",
        "lossCause": {
          "code": "vehcollision" 
        },
        "mainContact": {
          "policySystemId": "ab:0001-1"
        },
        "reporter": {
            "policySystemId": "ab:0001-1"
        }
      }
  },
  "included": {
    "ClaimContact": [
      {
        "attributes": {
          "firstName": "Robert",
          "lastName": "Farley",
          "contactSubtype": "Person"
        },
        "method": "post",
        "refid": "robertFarley",
        "uri": "/claim/v1/claims/this/contacts"
      }
    ],
    "VehicleIncident": [
      {
        "attributes": {
          "collision": true,
          "damageDescription": "Minor collision",
          "driver": {
            "policySystemId": "ab:0001-1"
          },
          "lossParty": {
            "code": "insured"
          },
          "vehicle": {
            "policySystemId": "pcveh:0001-1"
          }
        },
      "method": "post",
      "uri": "/claim/v1/claims/this/vehicle-incidents"
      },
      {
        "attributes": {
          "collision": true,
          "damageDescription": "Minor collision",
          "driver": {
            "refid": "robertFarley"
          },
          "lossParty": {
            "code": "third_party"
          },
          "vehicle": {
            "licensePlate": "2PIX534",
            "make": "Honda",
            "model": "Civic",
            "state": {
              "code": "CA"
            },
            "vin": "3DT6YUQ3K9003LP19",
            "year": 2019
          }
        },
      "method": "post",
      "uri": "/claim/v1/claims/this/vehicle-incidents"
      }
    ]
  }
}

Sample composite claim payload

The following payload creates a sample claim in a composite request. This includes creating an unverified policy, creating a draft claim for that policy, and then submitting the claim. (For information on how to create the claim's child objects, such as ClaimContacts and incidents, refer to the other topics in the ClaimCenter Business Flows section.)

{
  "requests": [
    {
      "body": {
        "data": {
          "attributes": {
            "policyNumber": "composite-FNOL-example",
            "policyType": {
              "code": "PersonalAuto"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/unverified-policies",
      "vars": [
        {
          "name": "policyId",
          "path": "$.data.attributes.id"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "coverageType": {
              "code": "PALiabilityCov"
            },
            "covTerms": [
              {
                "covTermSubtype": "FinancialCovTerm",
                "covTermOrder": 1,
                "covTermPattern": {
                  "code": "PALiability"
                },
                "modelAggregation": {
                  "code": "pi"
                },
                "modelRestriction": {
                  "code": "acc"
                },
                "financialAmount": {
                  "amount": "50000.00",
                  "currency": "usd"
                }
              },
              {
                "covTermSubtype": "ClassificationCovTerm",
                "covTermOrder": 2,
                "code": "Classification Code - 1",
                "description": "ClassificationCovTerm description"
              }
            ],
            "currency": {
              "code": "usd"
            },
            "exposureLimit": {
              "amount": "15000.00",
              "currency": "usd"
            },
            "incidentLimit": {
              "amount": "10000.00",
              "currency": "usd"
            },
            "notes": "Coverage of unverified policy",
            "state": {
              "code": "CA"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/unverified-policies/${policyId}/coverages"
    },
    {
      "body": {
        "data": {
          "attributes": {
            "addressBookUID": "UID-RayNewton-001",
            "emailAddress1": "RayNewton@email.com",
            "firstName": "Ray",
            "lastName": "Newton",
            "primaryAddress": {
              "addressLine1": "287 Kensington Rd. #1A",
              "city": "South Pasadena",
              "country": "US",
              "postalCode": "91145",
              "state": {
                "code": "CA"
              }
            },
            "primaryPhoneType": {
              "code": "work"
            },
            "contactSubtype": "Person",
            "workPhone": {
              "countryCode": {
                "code": "US"
              },
              "number": "818-446-1206"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/unverified-policies/${policyId}/contacts",
      "vars": [
        {
          "name": "insuredId",
          "path": "$.data.attributes.id"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "insured": {
              "id": "${insuredId}"
            }
          }
        }
      },
      "method": "patch",
      "uri": "/claim/v1/unverified-policies/${policyId}"
    },
    {
      "body": {
        "data": {
          "attributes": {
            "addressBookUID": "UID-HelenNewton-001",
            "emailAddress1": "HelenNewton@email.com",
            "firstName": "Helen",
            "lastName": "Newton",
            "primaryAddress": {
              "addressLine1": "287 Kensington Rd. #1A",
              "city": "South Pasadena",
              "country": "US",
              "postalCode": "91145",
              "state": {
                "code": "CA"
              }
            },
            "primaryPhoneType": {
              "code": "work"
            },
            "contactSubtype": "Person",
            "workPhone": {
              "countryCode": {
                "code": "US"
              },
              "number": "818-446-1206"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/unverified-policies/${policyId}/contacts",
      "vars": [
        {
          "name": "coveredContactId",
          "path": "$.data.attributes.id"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "coveredParties": [
              {
                "id": "${coveredContactId}"
              }
            ]
          }
        }
      },
      "method": "patch",
      "uri": "/claim/v1/unverified-policies/${policyId}"
    },
    {
      "body": {
        "data": {
          "attributes": {
            "description": "Vehicle Risk Unit Description",
            "vehicle": {
              "color": "Green",
              "licensePlate": "1ABC234",
              "make": "Honda",
              "manufacturer": {
                "code": "HOND"
              },
              "model": "Accord",
              "state": {
                "code": "CA"
              },
              "style": {
                "code": "passengercar"
              },
              "vin": "QWE327UH534NMK09P",
              "year": 2010
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/unverified-policies/${policyId}/vehicle-risk-units",
      "vars": [
        {
          "name": "vehicleId",
          "path": "$.data.attributes.vehicle.id"
        },
        {
          "name": "vehicleRUId",
          "path": "$.data.attributes.id"
        },
        {
          "name": "RUNumber",
          "path": "$.data.attributes.RUNumber"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "claimAggLimit": {
              "amount": "7000.00",
              "currency": "usd"
            },
            "personAggLimit": {
              "amount": "8000.00",
              "currency": "usd"
            },
            "coverageType": {
              "code": "PACollisionCov"
            },
            "covTerms": [
              {
                "covTermSubtype": "FinancialCovTerm",
                "covTermOrder": 1,
                "covTermPattern": {
                  "code": "PACollDeductible"
                },
                "modelAggregation": {
                  "code": "pi"
                },
                "modelRestriction": {
                  "code": "acc"
                },
                "financialAmount": {
                  "amount": "500.00",
                  "currency": "usd"
                }
              },
              {
                "covTermSubtype": "NumericCovTerm",
                "covTermOrder": 2,
                "numericValue": "20.20",
                "units": {
                  "code": "days"
                }
              }
            ],
            "currency": {
              "code": "usd"
            },
            "exposureLimit": {
              "amount": "10000.00",
              "currency": "usd"
            },
            "incidentLimit": {
              "amount": "20000.00",
              "currency": "usd"
            },
            "notes": "Coverage of vehicle risk unit"
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/unverified-policies/${policyId}/vehicle-risk-units/${vehicleRUId}/coverages"
    },
    {
      "body": {
        "data": {
          "attributes": {
            "lossDate": "2021-02-01T07:00:00.000Z",
            "lossLocation": {
              "addressLine1": "100 Main St.",
              "city": "San Mateo",
              "postalCode": "90123",
              "state": {
                "code": "CA"
              }
            },
            "policyNumber": "composite-FNOL-example",
            "reporter": {
              "id": "${insuredId}"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims",
      "vars": [
        {
          "name": "claimId",
          "path": "$.data.attributes.id"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "body": "Test note body"
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/notes"
    },
    {
      "body": {
        "data": {
          "attributes": {
            "collision": true,
            "collisionPoint": {
              "code": "03"
            },
            "damageDescription": "Damaged front bumper",
            "driver": {
              "id": "${insuredId}"
            },
            "lossParty": {
              "code": "insured"
            },
            "severity": {
              "code": "major-auto"
            },
            "vehicle": {
              "id": "${vehicleId}"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/vehicle-incidents",
      "vars": [
        {
          "name": "vehicleIncidentId",
          "path": "$.data.attributes.id"
        },
        {
          "name": "driverUri",
          "path": "$.data.attributes.driver.uri"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "coverageSubtype": {
              "code": "PACollisionCov"
            },
            "claimant": {
              "id": "${insuredId}"
            },
            "primaryCoverage": {
              "code": "PACollisionCov"
            },
            "vehicleIncident": {
              "id": "${vehicleIncidentId}"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/exposures",
      "vars": [
        {
          "name": "exposureId",
          "path": "$.data.attributes.id"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "cellPhone": {
              "countryCode": {
                "code": "US"
              },
              "number": "555-555-5555"
            },
            "dateOfBirth": "1928-11-18",
            "emailAddress1": "MitchMochizuki@email.com",
            "firstName": "Mitch",
            "homePhone": {
              "countryCode": {
                "code": "US"
              },
              "number": "555-555-5556"
            },
            "lastName": "Mochizuki",
            "licenseNumber": "ABCDE12345",
            "licenseState": {
              "code": "CA"
            },
            "primaryAddress": {
              "addressLine1": "1313 Albian Dr.",
              "city": "Anaheim",
              "country": "US",
              "county": "Orange County",
              "postalCode": "92802",
              "state": {
                "code": "CA"
              }
            },
            "primaryLanguage": {
              "code": "en_US"
            },
            "primaryLocale": {
              "code": "en_US"
            },
            "primaryPhoneType": {
              "code": "home"
            },
            "contactSubtype": "Person"
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/contacts",
      "vars": [
        {
          "name": "mitchMochizukiId",
          "path": "$.data.attributes.id"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "addressBookUID": "DOCTOR-12345",
            "dateOfBirth": "1959-06-11",
            "emailAddress1": "DanaEdwards@email.com",
            "firstName": "Dana",
            "lastName": "Edwards",
            "primaryAddress": {
              "addressLine1": "1000 Hospital Dr.",
              "city": "Princeton",
              "country": "US",
              "postalCode": "08540",
              "state": {
                "code": "NJ"
              }
            },
            "primaryLanguage": {
              "code": "en_US"
            },
            "primaryLocale": {
              "code": "en_US"
            },
            "primaryPhoneType": {
              "code": "work"
            },
            "contactSubtype": "Doctor",
            "workPhone": {
              "countryCode": {
                "code": "US"
              },
              "number": "666-666-6666"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/contacts",
      "vars": [
        {
          "name": "danaEdwardsId",
          "path": "$.data.attributes.id"
        }
      ]
    },
    {
      "body": {
        "data": {
          "attributes": {
            "ambulanceUsed": true,
            "bodyParts": [
              {
                "detailedBodyPart": {
                  "code": "57"
                },
                "detailedBodyPartDesc": {
                  "code": "57B"
                },
                "impairmentPercentage": 77,
                "ordering": 12,
                "primaryBodyPart": {
                  "code": "lower"
                },
                "sideOfBody": {
                  "code": "left"
                }
              }
            ],
            "description": "Head trauma, possible concussion",
            "detailedInjuryType": {
              "code": "07"
            },
            "disabledDueToAccident": {
              "code": "notdisabled"
            },
            "generalInjuryType": {
              "code": "specific"
            },
            "injuredPerson": {
              "id": "${mitchMochizukiId}"
            },
            "lossParty": {
              "code": "third_party"
            },
            "lostWages": false,
            "primaryDoctor": {
              "id": "${danaEdwardsId}"
            },
            "severity": {
              "code": "major-injury"
            },
            "treatmentType": {
              "code": "er"
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/injury-incidents"
    },
    {
      "body": {
        "data": {
          "attributes": {
            "collision": true,
            "collisionPoint": {
              "code": "03"
            },
            "damageDescription": "Damaged rear bumper",
            "driver": {
              "id": "${mitchMochizukiId}"
            },
            "lossParty": {
              "code": "third_party"
            },
            "severity": {
              "code": "major-auto"
            },
            "vehicle": {
              "color": "silver",
              "licensePlate": "MERLIN0",
              "make": "Subaru",
              "model": "Outback",
              "year": 2005
            }
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/vehicle-incidents"
    },
    {
      "body": {
        "data": {
          "attributes": {
            "addressBookUID": "REPAIRSHOP-12345",
            "companyName": "#(args.name)",
            "editableRoles": [
              {
                "active": true,
                "relatedTo": {
                  "id": "${claimId}",
                  "type": "Claim"
                },
                "role": {
                  "code": "repairshop"
                }
              }
            ],
            "contactSubtype": "AutoRepairShop"
          }
        }
      },
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/contacts"
	},
    {
      "method": "post",
      "uri": "/claim/v1/claims/${claimId}/submit"
    }
  ],
  "selections": [
    {
      "uri": "${driverUri}"
    }
  ]
}

Sample composite first-and-final

Composite requests can mimic the functionality of ClaimCenter Auto First-and-Final, in which a claim is created, paid out, and closed without adjudication.

For more information about Auto First-and-Final, see the ClaimCenter Application Guide.

Note:
  • Mimicing auto first-and-final claim processing can create entities that cannot be closed in the composite request. For example, workplan rules can create activities that the composite request is unaware of and therefore cannot complete. Depending on your configuration, you may need to execute additional steps to completely close the claim.
  • Activities can prevent claims and exposures from closing, and therefore you may need to close all activities automatically created during a composite request for claim closure.
  • You can POST /check-sets for composite requests for only non-recurring, final-payment checks; you cannot complete a partial payment transaction using composite requests.

Subrequest order

When executing a first and final claim within a composite request, you must execute the steps in the following order. If steps are executed in a different order, then some objects may get created automatically by ClaimCenter that conflict with objects created in later subrequests.
  1. POST the claim.

  2. POST the vehicle incident.

  3. POST an exposure with the following attributes
    1. The exposure's incident is the vehicle incident.

    2. The exposure's coverage is Comprehensive.

    3. The exposure's claimant is the insured.

  4. Submit the claim.

  5. POST the payment with the following attributes:

    1. The payment draws from the exposure's reserve line.

    2. The payment's payee is the insured.

Minimum composite request example

The following composite request uses the minimum composite requests for an immediate closing of claim and transaction payment (depending on your activity patten configuration).

  1. POST the claim:
    {
    "requests": [
      {
        "body": {
          "data": {
            "attributes": {
              "coverageInQuestion": false,
              "description": "Rear-ended by distracted driver",
              "faultRating": {
                "code": "nofault"
              },
              "howReported": {
                "code": "phone"
              },
              "incidentOnly": false,
              "jurisdiction": {
                "code": "CA"
              },
              "lossCause": {
                "code": "FallingObject"
              },
              "lossDate": " 2020-08-31T07:00:00.000Z)",
              "lossLocation": {
                "addressLine1": " 2850 S Delaware St ",
                "city": "San Mateo",
                "country": "US",
                "county": "San Mateo",
                "postalCode": "94404",
                "state": {
                  "code": "CA"
                }
              },
              "mainContact": {
                "policySystemId": "pc:contact_1"
              },
              "policyNumber": "POLICY-ID",
              "reportedByType": {
                "code": "self"
              },
              "reporter": {
                "policySystemId": "pc:contact_1"
              }
            }
          }
          },
        "method": "post",
        "uri": "/claim/v1/claims",
        "vars": [
          {
            "name": "claimId",
            "path": "$.data.attributes.id"
          }
        ]
      },
  2. POST the vehicle incident.
      {
        "body": {
          "data": {
            "attributes": {
              "collision": true,
              "damageDescription": "Tree fell",
              "lossParty": {
                "code": "insured"
              },
              "vehicle": {
                "policySystemId": "pcveh:1"
              }
            }
          }
        },
        "method": "post",
        "uri": "/claim/v1/claims/${claimId}/vehicle-incidents",
        "vars": [
          {
            "name": "firstPartyVehicleIncidentId",
            "path": "$.data.attributes.id"
          }
        ]
      },
  3. POST an exposure associated with the vehicle incident from step 2 with comprehensive coverage and the insured and the claimant.
      {
        "body": {
          "data": {
            "attributes": {
              "coverage": {
                "policySystemId": "pc:coverage_2"
              },
              "coverageSubtype": {
                "code": "PAComprehensiveCov"
              },
              "claimant": {
                "policySystemId": "pc:contact_1"
              },
              "primaryCoverage": {
                "code": "PAComprehensiveCov"
              },
              "vehicleIncident": {
                "id": "${firstPartyVehicleIncidentId}"
              }
            }
          }
        },
        "method": "post",
        "uri": "/claim/v1/claims/${claimId}/exposures",
        "vars": [
          {
            "name": "exposureId",
            "path": "$.data.attributes.id"
          }
        ]
      },
  4. Submit the claim.
      {
        "body": {
          "data": {
            "attributes": {
              "initialAssignment": {
                "groupId": "#(args.groupId)",
                "userId": "#(args.adjusterId)"
              }
            }
          }
        },
        "method": "post",
        "uri": "/claim/v1/claims/${claimId}/submit"
      },
  5. POST a payment to the insured.
      {
        "body": {
          "data": {
            "attributes": {
              "primaryCheckToWrite": {
                "paymentsToWrite": [
                  {
                    "lineItems": [
                      {
                        "transactionAmount": {
                          "amount": "500",
                          "currency": "usd"
                        }
                      }
                    ],
                    "paymentType": {
                      "code": "final"
                    },
                    "reserveLine": {
                      "costCategory": {
                        "code": "body"
                      },
                      "costType": {
                        "code": "claimcost"
                      },
                      "exposure": {
                        "id": "${exposureId}"
                       },
                      "reservingCurrency": {
                        "code": "usd"
                      }
                    },
                    "currency": {
                      "code": "usd"
                    }
                  }
                ],
                "payees": [
                  {
                    "contact": {
                      "policySystemId": "pc:contact_1"
                    },
                    "payeeType": {
                      "code": "other"
                    }
                  }
                ],
                "paymentMethod": {
                  "code": "check"
                },
                "mailTo": "Ray Newton",
                "payTo": "Ray Newton",
                "mailingAddress": {
                  "addressLine1": "2850 S Delaware St ",
                  "city": "San Mateo",
                  "country": "US",
                  "county": "San Mateo",
                  "postalCode": "94403",
                  "state": {
                    "code": "CA"
                  }
                }
              }
            }
          }
        },
        "method": "post",
        "uri": "#('/claim/v1/claims/${claimId}/check-sets')",
        "vars": [
          {
            "name": "checkId",
            "path": "$.data.attributes.checks[0].id"
          }
        ]
      }
      ]
    }