Overview

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

• List Attorneys - Retrieve paginated list of attorneys with filtering and sorting
• Create Attorney - Create a new attorney
• Get Attorney - Retrieve a single attorney by ID
• Update Attorney - Update an existing attorney
• Delete Attorney - Soft delete an attorney

---

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)

Pagination

Parameter	Type	Default	Description
page	integer	1	Page number (1-based, page size 50)

Response includes:

• items - Array of attorneys for the current page
• totalCount - 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": "[e-mail]",
      "phoneNumber": "[phone]",
      "lawFirmId": "770e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-01-16T14:20:00.000Z"
    }
  ],
  "totalCount": 1
}

---