Add Submission Loss History Entries

Appends loss history entries to a submission without replacing existing ones. The new entries are added after any previously stored entries.

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

The request must contain at least one entry — an empty array is rejected with a 400 error. Unknown fields are also rejected.

Required permission: submission:update

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

cURL

singleEntry

curl --request POST \
  --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": 2023,
      "data": {
        "company": "Acme Insurance Co",
        "policyNumber": "POL-2023-001",
        "policyPremium": 12000,
        "totalIncurred": 8000,
        "indemnityPaid": 4000,
        "expensesPaid": 1500,
        "totalReserves": 2500,
        "claimDescription": "Property damage from storm",
        "reportDate": "2023-09-15T00: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 to append. Must contain at least one entry.

Minimum array length: 1

Show child attributes

Response

200

application/json

Entries appended successfully.

success · boolean · required

Example:

true