Skip to main content
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

​
Nullable Fields

The following fields may be null in the response:
FieldWhen null
caseNumberCase number not assigned
caseNameCase name not provided
lawsuitFiledDateFiling date not recorded
suitServedDateService date not recorded
trialDateTrial date not scheduled
venueNameVenue not specified
venueAddressVenue address not provided
judgeNameJudge not assigned
plaintiffsNo plaintiffs recorded
plaintiffAttorneyIdNo plaintiff attorney assigned
plaintiffLawFirmIdNo plaintiff law firm assigned
plaintiffAddressPlaintiff address not provided
settlementDemandNo settlement demand recorded
settlementTypeSettlement type not set
arbitrationInvolvedArbitration status not recorded
dateDefenseCounselAddedDefense counsel date not recorded
expertDefenseNo defense expert assigned
expertPlaintiffNo plaintiff expert assigned
declaratoryJudgementFiledDateNo declaratory judgement filed
createdAtTimestamp not tracked (legacy records)
updatedAtLawsuit has never been updated

​
Permissions

Access to lawsuits requires the appropriate permissions based on your API key:
OperationRequired Permission
Create Lawsuitcompany.event:export
Get Lawsuitcompany.event:export
Update Lawsuitcompany.event:export
Delete Lawsuitcompany.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"
}