List Defendants

curl --request GET \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "companyId": "660e8400-e29b-41d4-a716-446655440000",
      "lawsuitId": "770e8400-e29b-41d4-a716-446655440000",
      "insuredId": "aa0e8400-e29b-41d4-a716-446655440000",
      "nonInsuredName": null,
      "phoneNumber": null,
      "email": null,
      "attorneyId": null,
      "lawFirmId": null,
      "createdAt": "2026-02-10T08:00:00.000Z",
      "updatedAt": null
    }
  ],
  "totalCount": 2
}

GET

api

external

companies

{companyId}

events

{eventId}

lawsuit

defendants

List Defendants

curl --request GET \
  --url https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants \
  --header 'Authorization: <api-key>'

import requests

url = "https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "companyId": "660e8400-e29b-41d4-a716-446655440000",
      "lawsuitId": "770e8400-e29b-41d4-a716-446655440000",
      "insuredId": "aa0e8400-e29b-41d4-a716-446655440000",
      "nonInsuredName": null,
      "phoneNumber": null,
      "email": null,
      "attorneyId": null,
      "lawFirmId": null,
      "createdAt": "2026-02-10T08:00:00.000Z",
      "updatedAt": null
    }
  ],
  "totalCount": 2
}

Authorizations

Authorization

string

header

required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId

string<uuid>

required

Company identifier

eventId

string<uuid>

required

Event identifier

Query Parameters

Filter by specific defendant ID(s)

filterText

string

Search across quote number, description, and other text fields

sortBy

enum<string>

default:createdAt

Field to sort by (default createdAt)

Available options:

createdAt,

updatedAt

sortDirection

enum<string>

default:desc

Sort direction (default desc)

Available options:

asc,

desc

page

integer

default:1

Page number (1-based, default 1, page size 50)

Required range: x >= 1

Response

Paginated list of defendants

items

object[]

Show child attributes

totalCount

integer

Total number of matching defendants across all pages

Getting Started

Submissions

Quotes

Assignees

Notes

Events

Brokerages

Brokers

Payees

Transaction Categories

Event Financials

Policies

Exposures

Attorneys

Lawsuits

Defendants

Configuration Fields

Configuration Rating Fields

Configuration Rating Outputs

Configuration Rating Presets

Configuration Rating Form Logic

Configuration Presets

Exposure Types

Coverage Types

Smart Tags

Address

Reference

List Defendants

Authorizations

Path Parameters

Query Parameters

Response