Set Submission Loss History

Replaces the entire loss history on a submission. The request body contains an array of loss history entries — any previously stored entries are overwritten. Unknown fields are rejected with a 400 error.

For FMV1-enabled companies, setting loss history automatically recomputes computed loss history aggregation fields on all quotes attached to the submission.

Required permission: submission:update

PUT /api/external/companies/{companyId}/submissions/{submissionId}/loss-history

cURL

singleEntry

curl --request PUT \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/submissions/{submissionId}/loss-history \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "history": [
    {
      "year": 2022,
      "data": {
        "company": "Acme Insurance Co",
        "policyNumber": "POL-2022-001",
        "policyPremium": 10000,
        "totalIncurred": 10000,
        "indemnityPaid": 5000,
        "expensesPaid": 2000,
        "totalReserves": 3000,
        "claimDescription": "Slip and fall at insured premises",
        "reportDate": "2022-06-20T00:00:00.000Z"
      }
    }
  ]
}
'

200

success

{
  "success": true
}

Authorizations

Authorization · string · header · required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId · string<uuid> · required

Company identifier

submissionId · string<uuid> · required

Submission identifier

Body

application/json

history · object[] · required

Loss history entries. Send an empty array to clear all loss history.

Show child attributes

Response

200

application/json

Loss history saved successfully.

success · boolean · required

Example:

true