Get Defendant

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

import requests

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

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/{defendantId}', 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/{defendantId}",
  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/{defendantId}"

	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))

}

HttpResponse<String> response = Unirest.get("https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants/{defendantId}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

{
  "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"
}

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>'

import requests

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

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/{defendantId}', 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/{defendantId}",
  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/{defendantId}"

	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))

}

HttpResponse<String> response = Unirest.get("https://app.aiinsurance.io/api/external/companies/{companyId}/events/{eventId}/lawsuit/defendants/{defendantId}")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

{
  "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 API key in the Authorization header.

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

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

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)

Create Defendant Update Defendant

⌘I

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

Get Defendant

Authorizations

Path Parameters

Response