OpenAPI Specification
openapi: 3.1.0
info:
title: Lex Machina Alerts Attorneys API
version: '20260324'
description: Alerts.
servers:
- url: https://api.lexmachina.com
description: Lex Machina production API
tags:
- name: Attorneys
description: Attorney data.
paths:
/attorneys/{attorney_id}:
get:
tags:
- Attorneys
summary: Get Attorney
description: 'Gets data for a single attorney.
- **attorney_id**: the Lex Machina attorneyId'
operationId: get_attorney
security:
- JwtAccessBearer: []
parameters:
- name: attorney_id
in: path
required: true
schema:
type: integer
title: Attorney Id
responses:
'200':
description: Success
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/AttorneyData'
- $ref: '#/components/schemas/AttorneyReference'
title: Response Get Attorney Attorneys Attorney Id Get
examples:
Single Attorney:
summary: Single Attorney
value:
name: Gerry L. Spence
attorneyId: 110161257
'404':
description: Not found
content:
application/json:
examples:
Attorney Not Found:
summary: Attorney Not Found
value:
detail: No attorney matching provided attorney ID was found
'422':
description: Error - 422
content:
application/json:
examples:
Invalid Input:
summary: Invalid Input
value:
detail:
- type: int_parsing
loc:
- path
- attorney_id
msg: Input should be a valid integer, unable to parse string as an integer
input: string
Validation error:
summary: Validation error
value:
summary: Invalid input
detail:
- type: parsing
loc:
- path
- query
- body
msg: invalid input
input: '-1'
'401':
description: Invalid or expired token
content:
application/json:
examples:
Expired token:
summary: Expired token
value:
detail: 'Token time expired: Signature has expired.'
Invalid token:
summary: Invalid token
value:
detail: Invalid token
/attorneys:
get:
tags:
- Attorneys
summary: Get Attorneys
description: 'Gets data for one or more attorneys.
- **attorneyIds**: the Lex Machina attorneyIds
If any of the the attorneyIds given are not the current lexmachina attorneyId, the results will include inputId for disambugation'
operationId: get_attorneys
security:
- JwtAccessBearer: []
parameters:
- name: attorneyIds
in: query
required: true
schema:
type: array
uniqueItems: true
items:
type: integer
minItems: 1
maxItems: 500
title: Attorneyids
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
anyOf:
- $ref: '#/components/schemas/AttorneyData'
- $ref: '#/components/schemas/AttorneyReference'
title: Response Get Attorneys Attorneys Get
examples:
Multiple Attorneys:
summary: Multiple Attorneys
value:
- name: Gerry L. Spence
attorneyId: 110161257
- name: Alan M. Dershowitz
attorneyId: 18594138
'404':
description: Not found
content:
application/json:
examples:
Attorneys Not Found:
summary: Attorneys Not Found
value:
detail: No attorneys matching provided attorney IDs were found
'401':
description: Invalid or expired token
content:
application/json:
examples:
Expired token:
summary: Expired token
value:
detail: 'Token time expired: Signature has expired.'
Invalid token:
summary: Invalid token
value:
detail: Invalid token
'422':
description: Error - 422
content:
application/json:
examples:
Validation error:
summary: Validation error
value:
summary: Invalid input
detail:
- type: parsing
loc:
- path
- query
- body
msg: invalid input
input: '-1'
/search-attorneys:
get:
tags:
- Attorneys
summary: Search Attorneys
description: 'Searches for attorneys.
- **q**: the query string
- **page_number**: page number of the results
- **page_size**: results per page
This is a case-insensitive search that will match anywhere within the name of the attorney.
The results will have page and totalCount fields as well as a convenience link via the field nextPage.'
operationId: search_attorneys
security:
- JwtAccessBearer: []
parameters:
- name: q
in: query
required: true
schema:
type: string
title: Q
- name: pageNumber
in: query
required: false
schema:
type: integer
default: 1
title: Pagenumber
- name: pageSize
in: query
required: false
schema:
type: integer
default: 1
title: Pagesize
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/AttorneySearchResults'
examples:
Search Attorneys By Name:
summary: Search Attorneys By Name
value:
totalCount: 30967
page: 2
nextPage: https://api.lexmachina.com/search-attorneys?q=elizabeth&pageNumber=2&pageSize=1?q=elizabeth&pageNumber=3&pageSize=1
attorneys:
- name: Karen Elizabeth Keller
attorneyId: 3393
url: https://api.lexmachina.com/attorneys/3393
'422':
description: Error - 422
content:
application/json:
examples:
Invalid Page:
summary: Invalid Page
value:
detail: Invalid page.
Validation error:
summary: Validation error
value:
summary: Invalid input
detail:
- type: parsing
loc:
- path
- query
- body
msg: invalid input
input: '-1'
'401':
description: Invalid or expired token
content:
application/json:
examples:
Expired token:
summary: Expired token
value:
detail: 'Token time expired: Signature has expired.'
Invalid token:
summary: Invalid token
value:
detail: Invalid token
'404':
description: Not found
content:
application/json:
examples:
Not found:
summary: Not found
value:
summary: Unknown id
detail: Not Found
components:
schemas:
AttorneyReference:
properties:
name:
type: string
title: Name
attorneyId:
type: integer
title: Attorneyid
url:
type: string
title: Url
inputId:
type: integer
title: Inputid
additionalProperties: false
type: object
required:
- name
- attorneyId
- url
- inputId
title: AttorneyReference
description: 'Indicates that the Lex Machina attorney id input was has changed,
the inputId is the ID given that should map to the returned attorneyId.'
AttorneySearchResults:
properties:
totalCount:
type: integer
title: Totalcount
page:
type: integer
title: Page
nextPage:
anyOf:
- type: string
- type: 'null'
title: Nextpage
attorneys:
items:
$ref: '#/components/schemas/AttorneyResult'
type: array
title: Attorneys
additionalProperties: false
type: object
required:
- totalCount
- page
- attorneys
title: AttorneySearchResults
AttorneyData:
properties:
name:
type: string
title: Name
attorneyId:
type: integer
title: Attorneyid
additionalProperties: false
type: object
required:
- name
- attorneyId
title: AttorneyData
AttorneyResult:
properties:
name:
type: string
title: Name
attorneyId:
type: integer
title: Attorneyid
url:
type: string
title: Url
additionalProperties: false
type: object
required:
- name
- attorneyId
- url
title: AttorneyResult
securitySchemes:
JwtAccessBearer:
type: http
scheme: bearer