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.
Attorneys represent legal professionals involved in insurance claims and lawsuits. The Attorneys API allows you to programmatically create, read, update, and delete attorney information within your company.
Key Concepts:
- Attorneys are company-scoped, reusable entities that can be associated with lawsuits
- An attorney can serve as plaintiff counsel (on a lawsuit) or defense counsel (on a defendant)
- Attorneys can optionally be linked to a law firm payee via
lawFirmId
API Endpoints
Nullable Fields
The following fields may be null in the response:
| Field | When null |
|---|
email | Email not provided |
phoneNumber | Phone number not provided |
lawFirmId | No associated law firm |
createdAt | Timestamp not tracked (legacy records) |
updatedAt | Attorney has never been updated |
Filtering and Sorting
Filter Parameters
| Parameter | Type | Description |
|---|
id | string or array | Filter by specific attorney ID(s) |
filterText | string | Text search across attorney name |
Sorting Parameters
| Parameter | Type | Default | Description |
|---|
sortBy | string | createdAt | Field to sort by (createdAt, updatedAt, name) |
sortDirection | string | desc | Sort direction (asc or desc) |
| Parameter | Type | Default | Description |
|---|
page | integer | 1 | Page number (1-based, page size 50) |
items - Array of attorneys for the current pagetotalCount - Total number of matching attorneys across all pages
Permissions
Access to attorneys requires the appropriate permissions based on your API key:
| Operation | Required Permission |
|---|
| List Attorneys | company.attorney:read |
| Get Attorney | company.attorney:read |
| Create Attorney | company.attorney:create |
| Update Attorney | company.attorney:update |
| Delete Attorney | company.attorney:delete |
Example Response
{
"items": [
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"companyId": "660e8400-e29b-41d4-a716-446655440000",
"name": "Jane Smith",
"email": "jane@smithlaw.com",
"phoneNumber": "+1-555-123-4567",
"lawFirmId": "770e8400-e29b-41d4-a716-446655440000",
"createdAt": "2026-01-15T10:30:00.000Z",
"updatedAt": "2026-01-16T14:20:00.000Z"
}
],
"totalCount": 1
}
