Skip to main content
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:
FieldWhen null
emailEmail not provided
phoneNumberPhone number not provided
lawFirmIdNo associated law firm
createdAtTimestamp not tracked (legacy records)
updatedAtAttorney has never been updated

​
Filtering and Sorting

​
Filter Parameters

ParameterTypeDescription
idstring or arrayFilter by specific attorney ID(s)
filterTextstringText search across attorney name

​
Sorting Parameters

ParameterTypeDefaultDescription
sortBystringcreatedAtField to sort by (createdAt, updatedAt, name)
sortDirectionstringdescSort direction (asc or desc)

​
Pagination

ParameterTypeDefaultDescription
pageinteger1Page 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:
OperationRequired Permission
List Attorneyscompany.attorney:read
Get Attorneycompany.attorney:read
Create Attorneycompany.attorney:create
Update Attorneycompany.attorney:update
Delete Attorneycompany.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
}