Skip to main content
Defendants represent parties named in a lawsuit. They are sub-resources of lawsuits, which are themselves sub-resources of events. The Defendants API allows you to create, retrieve, update, and delete defendant information for a specific lawsuit. Key Concepts:
  • Defendants belong to a lawsuit, accessed via the event path: /events/{eventId}/lawsuit/defendants
  • Each defendant is either an insured (linked via insuredId) or a non-insured party (identified by nonInsuredName) — exactly one must be set
  • Defendants can optionally be linked to an attorney and/or law firm
  • Deleting a defendant is a soft delete — the record is preserved but no longer returned by GET or LIST

​
API Endpoints

​
Nullable Fields

The following fields may be null in the response:
FieldWhen null
insuredIdDefendant is a non-insured party
nonInsuredNameDefendant is an insured
phoneNumberPhone number not provided
emailEmail not provided
attorneyIdNo attorney assigned
lawFirmIdNo law firm assigned
createdAtTimestamp not tracked (legacy records)
updatedAtDefendant has never been updated

​
Filtering and Sorting

​
Filter Parameters

ParameterTypeDescription
idstring or arrayFilter by specific defendant ID(s)
filterTextstringText search across defendant fields

​
Sorting Parameters

ParameterTypeDefaultDescription
sortBystringcreatedAtField to sort by (createdAt, updatedAt)
sortDirectionstringdescSort direction (asc or desc)

​
Pagination

ParameterTypeDefaultDescription
pageinteger1Page number (1-based, page size 50)
Response includes:
  • items - Array of defendants for the current page
  • totalCount - Total number of matching defendants across all pages

​
Permissions

Access to defendants requires the appropriate permissions based on your API key:
OperationRequired Permission
List Defendantscompany.event:export
Create Defendantcompany.event:export
Get Defendantcompany.event:export
Update Defendantcompany.event:export
Delete Defendantcompany.event:export

​
Example Response

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "companyId": "660e8400-e29b-41d4-a716-446655440000",
      "lawsuitId": "770e8400-e29b-41d4-a716-446655440000",
      "insuredId": null,
      "nonInsuredName": "John Doe",
      "phoneNumber": "+1-555-123-4567",
      "email": "john@example.com",
      "attorneyId": "880e8400-e29b-41d4-a716-446655440000",
      "lawFirmId": "990e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-02-15T10:30:00.000Z",
      "updatedAt": "2026-02-16T14:20:00.000Z"
    }
  ],
  "totalCount": 1
}