Skip to main content
GET
/
api
/
external
/
companies
/
{companyId}
/
events
/
{eventId}
/
lawsuit
/
defendants
/
{defendantId}
Get Defendant
curl --request GET \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants/{defendantId} \
  --header 'Authorization: <api-key>'
{
  "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"
}

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

​
defendantId
string<uuid>
required

Defendant identifier

Response

Defendant details

A defendant associated with a lawsuit

​
id
string<uuid>

Defendant identifier

​
companyId
string<uuid>

Company identifier

​
lawsuitId
string<uuid>

Associated lawsuit identifier

​
insuredId
string<uuid> | null

Associated insured identifier (mutually exclusive with nonInsuredName)

​
nonInsuredName
string | null

Name of non-insured defendant (mutually exclusive with insuredId)

​
phoneNumber
string | null

Defendant phone number

​
email
string<email> | null

Defendant email address

​
attorneyId
string<uuid> | null

Associated attorney identifier

​
lawFirmId
string<uuid> | null

Associated law firm payee identifier

​
createdAt
string<date-time> | null

When the defendant was created (ISO 8601)

​
updatedAt
string<date-time> | null

When the defendant was last updated (ISO 8601)