> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiinsurance.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/api-reference/lawsuits/create-lawsuit)** - Create a lawsuit for an event (409 if one exists)
* **[Get Lawsuit](/api-reference/lawsuits/get-lawsuit)** - Retrieve the lawsuit for an event
* **[Update Lawsuit](/api-reference/lawsuits/update-lawsuit)** - Update the lawsuit for an event
* **[Delete Lawsuit](/api-reference/lawsuits/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

```json theme={null}
{
  "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"
}
```

***