Skip to main content
GET
/
api
/
external
/
companies
/
{companyId}
/
events
/
{eventId}
/
lawsuit
Get Lawsuit
curl --request GET \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit \
  --header 'Authorization: <api-key>'
{
  "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",
    "structuredValue": {
      "streetNumber": "100",
      "streetName": "Court St",
      "city": "Springfield",
      "state": {
        "short": "IL",
        "long": "Illinois"
      },
      "postalCode": "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"
}

Authorizations

Authorization
string
header
required

API key authentication. Include your key in the Authorization header: Authorization: ApiKey YOUR-API-KEY

Path Parameters

companyId
string<uuid>
required

Company identifier

eventId
string<uuid>
required

Event identifier

Response

Lawsuit details

A lawsuit associated with an event

id
string<uuid>

Lawsuit identifier

companyId
string<uuid>

Company identifier

eventId
string<uuid>

Associated event identifier

caseNumber
string | null

Court case number

caseName
string | null

Name of the case

lawsuitFiledDate
string<date-time> | null

Date lawsuit was filed (ISO 8601)

suitServedDate
string<date-time> | null

Date suit was served (ISO 8601)

trialDate
string<date-time> | null

Scheduled trial date (ISO 8601)

venueName
string | null

Name of the court venue

venueAddress
object

Address of the court venue

judgeName
string | null

Name of the presiding judge

plaintiffs
string[] | null

List of plaintiff names

plaintiffAttorneyId
string<uuid> | null

Attorney representing the plaintiff

plaintiffLawFirmId
string<uuid> | null

Law firm representing the plaintiff

plaintiffAddress
object

Address of the plaintiff

settlementDemand
string | null

Settlement demand amount

settlementType
string | null

Settlement type code (S=Settlement, N=No Settlement, L=Litigated, C=Closed)

arbitrationInvolved
string | null

Whether arbitration is involved (Yes/No)

dateDefenseCounselAdded
string<date-time> | null

Date defense counsel was added (ISO 8601)

expertDefense
string | null

Defense expert information

expertPlaintiff
string | null

Plaintiff expert information

declaratoryJudgementFiledDate
string<date-time> | null

Date declaratory judgement was filed (ISO 8601)

createdAt
string<date-time> | null

When the lawsuit was created (ISO 8601)

updatedAt
string<date-time> | null

When the lawsuit was last updated (ISO 8601)