Overview

Lawsuits represent legal proceedings associated with insurance events. Each event can have at most one lawsuit. The Lawsuits API allows you to create, retrieve, update, and delete lawsuit information for a specific event.

Key Concepts:

• A lawsuit is a 1:1 sub-resource of an event — each event has at most one lawsuit
• Lawsuits are accessed via the event path: /events/{eventId}/lawsuit
• There is no list endpoint — use the GET endpoint to retrieve the single lawsuit for an event
• Creating a lawsuit when one already exists returns 409 Conflict
• Deleting a lawsuit is a soft delete — the record is preserved but no longer returned by GET

---

API Endpoints

• Create Lawsuit - Create a lawsuit for an event (409 if one exists)
• Get Lawsuit - Retrieve the lawsuit for an event
• Update Lawsuit - Update the lawsuit for an event
• Delete Lawsuit - Soft delete the lawsuit for an event

---

Nullable Fields

The following fields may be null in the response:

Field	When null
caseNumber	Case number not assigned
caseName	Case name not provided
lawsuitFiledDate	Filing date not recorded
suitServedDate	Service date not recorded
trialDate	Trial date not scheduled
venueName	Venue not specified
venueAddress	Venue address not provided
judgeName	Judge not assigned
plaintiffs	No plaintiffs recorded
plaintiffAttorneyId	No plaintiff attorney assigned
plaintiffLawFirmId	No plaintiff law firm assigned
plaintiffAddress	Plaintiff address not provided
settlementDemand	No settlement demand recorded
settlementType	Settlement type not set
arbitrationInvolved	Arbitration status not recorded
dateDefenseCounselAdded	Defense counsel date not recorded
expertDefense	No defense expert assigned
expertPlaintiff	No plaintiff expert assigned
declaratoryJudgementFiledDate	No declaratory judgement filed
createdAt	Timestamp not tracked (legacy records)
updatedAt	Lawsuit has never been updated

---

Permissions

Access to lawsuits requires the appropriate permissions based on your API key:

Operation	Required Permission
Create Lawsuit	company.event:export
Get Lawsuit	company.event:export
Update Lawsuit	company.event:export
Delete Lawsuit	company.event:export

---

Example Response

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "companyId": "660e8400-e29b-41d4-a716-446655440000",
  "eventId": "770e8400-e29b-41d4-a716-446655440000",
  "caseNumber": "CASE-2026-001",
  "caseName": "Smith v. Jones Insurance Co.",
  "lawsuitFiledDate": "2026-01-10T00:00:00.000Z",
  "suitServedDate": "2026-01-15T00:00:00.000Z",
  "trialDate": "2026-06-01T00:00:00.000Z",
  "venueName": "District Court of Springfield",
  "venueAddress": {
    "value": "100 Court St, Springfield, IL 62701"
  },
  "judgeName": "Hon. Sarah Williams",
  "plaintiffs": ["John Smith", "Mary Smith"],
  "plaintiffAttorneyId": "880e8400-e29b-41d4-a716-446655440000",
  "plaintiffLawFirmId": "990e8400-e29b-41d4-a716-446655440000",
  "plaintiffAddress": null,
  "settlementDemand": "250000",
  "settlementType": "N",
  "arbitrationInvolved": "No",
  "dateDefenseCounselAdded": "2026-01-20T00:00:00.000Z",
  "expertDefense": "Dr. Expert Defense",
  "expertPlaintiff": "Dr. Expert Plaintiff",
  "declaratoryJudgementFiledDate": null,
  "createdAt": "2026-01-10T10:30:00.000Z",
  "updatedAt": "2026-02-01T14:20:00.000Z"
}

---