OpenAPI Specification
openapi: 3.1.0
info:
title: Lex Machina Alerts Judges API
version: '20260324'
description: Alerts.
servers:
- url: https://api.lexmachina.com
description: Lex Machina production API
tags:
- name: Judges
description: Judge data.
paths:
/bankruptcy-judges/{bankruptcy_judge_id}:
get:
tags:
- Judges
summary: Get Bankruptcy Judge
description: 'Gets data for a single federal bankruptcy judge.
- **bankruptcy_judge_id**: the Lex Machina bankruptcyJudgeId'
operationId: get_bankruptcy_judge
security:
- JwtAccessBearer: []
parameters:
- name: bankruptcy_judge_id
in: path
required: true
schema:
type: integer
title: Bankruptcy Judge Id
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/BankruptcyJudgeData'
examples:
Single Bankruptcy Judge:
summary: Single Bankruptcy Judge
value:
name: Erik P. Kimball
bankruptcyJudgeId: 539
initials: EPK
caseCountByCourt:
- court: total
count: 901
'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
'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'
/bankruptcy-judges:
get:
tags:
- Judges
summary: Get Bankruptcy Judges
description: 'Gets data for one or more federal bankruptcy judges.
- **attorneyIds**: the Lex Machina bankruptcyJudgeIds'
operationId: get_bankruptcy_judges
security:
- JwtAccessBearer: []
parameters:
- name: bankruptcyJudgeIds
in: query
required: true
schema:
type: array
uniqueItems: true
items:
type: integer
minItems: 1
maxItems: 500
title: Bankruptcyjudgeids
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BankruptcyJudgeData'
title: Response Get Bankruptcy Judges Bankruptcy Judges Get
examples:
Multiple Bankruptcy Judges:
summary: Multiple Bankruptcy Judges
value:
- name: Mindy A. Mora
bankruptcyJudgeId: 704
initials: MAM
caseCountByCourt:
- court: total
count: 410
- name: Erik P. Kimball
bankruptcyJudgeId: 539
initials: EPK
caseCountByCourt:
- court: total
count: 901
'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
'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'
/federal-judges/{federal_judge_id}:
get:
tags:
- Judges
summary: Get Federal Judge
description: 'Gets data for a single federal Article III judge.
- **judge_id**: the judge id'
operationId: get_federal_judge
security:
- JwtAccessBearer: []
parameters:
- name: federal_judge_id
in: path
required: true
schema:
type: integer
title: Federal Judge Id
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/FederalJudgeData'
examples:
Single Federal Judge:
summary: Single Federal Judge
value:
name: Sidney H. Stein
federalJudgeId: 2282
initials: SHS
dateOfBirth: '1945-01-01'
caseCountByCourt:
- court: total
count: 1712
nominatingPresident: William J. Clinton
'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
'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'
/federal-judges:
get:
tags:
- Judges
summary: Get Federal Judges
description: 'Gets data for one or more federal Article III judges.
- **judgeIds**: the judge Ids'
operationId: get_federal_judges
security:
- JwtAccessBearer: []
parameters:
- name: federalJudgeIds
in: query
required: true
schema:
type: array
uniqueItems: true
items:
type: integer
minItems: 1
maxItems: 500
title: Federaljudgeids
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FederalJudgeData'
title: Response Get Federal Judges Federal Judges Get
examples:
Multiple Federal Judges:
summary: Multiple Federal Judges
value:
- name: Susan Webber Wright
federalJudgeId: 2664
initials: SWW
dateOfBirth: '1948-01-01'
caseCountByCourt:
- court: total
count: 1314
nominatingPresident: George H.W. Bush
- name: Sidney H. Stein
federalJudgeId: 2282
initials: SHS
dateOfBirth: '1945-01-01'
caseCountByCourt:
- court: total
count: 1712
nominatingPresident: William J. Clinton
'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
'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'
/magistrate-judges/{magistrate_judge_id}:
get:
tags:
- Judges
summary: Get Magistrate
description: 'Gets data for a single federal magistrate judge.
- **magistrate_judge_id**: the Lex Machina magistrateJudgeId'
operationId: get_magistrate
security:
- JwtAccessBearer: []
parameters:
- name: magistrate_judge_id
in: path
required: true
schema:
type: integer
title: Magistrate Judge Id
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/MagistrateJudgeData'
examples:
Single Magistrate Judge:
summary: Single Magistrate Judge
value:
name: Margaret J Kravchuk
magistrateJudgeId: 801
initials: MJK
caseCountByCourt:
- court: total
count: 1720
'404':
description: Not found
content:
application/json:
examples:
Magistrate Judge Not Found:
summary: Magistrate Judge Not Found
value:
detail: No magistrates matching provided magistrate IDs were found
'422':
description: Error - 422
content:
application/json:
examples:
Invalid Input:
summary: Invalid Input
value:
detail:
- type: int_parsing
loc:
- path
- magistrate_judge_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
/magistrate-judges:
get:
tags:
- Judges
summary: Get Magistrates
description: 'Gets data for a one or more federal magistrate judges.
- **magistrateJudgeIds**: the Lex Machina magistrateJudgeIds'
operationId: get_magistrates
security:
- JwtAccessBearer: []
parameters:
- name: magistrateJudgeIds
in: query
required: true
schema:
type: array
uniqueItems: true
items:
type: integer
minItems: 1
maxItems: 500
title: Magistratejudgeids
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/MagistrateJudgeData'
title: Response Get Magistrates Magistrate Judges Get
examples:
Multiple Magistrate Judges:
summary: Multiple Magistrate Judges
value:
- name: Margaret J Kravchuk
magistrateJudgeId: 801
initials: MJK
caseCountByCourt:
- court: total
count: 1720
- name: Zahid N Quraishi
magistrateJudgeId: 1385
initials: ZNQ
caseCountByCourt:
- court: total
count: 1212
'404':
description: Not found
content:
application/json:
examples:
Multiple Magistrate Judges:
summary: Multiple Magistrate Judges
value:
detail: No magistrates matching provided magistrate 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'
/state-judges/{state_judge_id}:
get:
tags:
- Judges
summary: Get State Judge
description: 'Gets data on a single state judge.
- **state_judge_id**: the Lex Machina stateJudgeId'
operationId: get_state_judge
security:
- JwtAccessBearer: []
parameters:
- name: state_judge_id
in: path
required: true
schema:
type: integer
title: State Judge Id
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/StateJudgeData'
examples:
Single State Judge:
summary: Single State Judge
value:
name: Daryl L Moore
stateJudgeId: 775
courtPosting: Texas District Court, 333rd Judicial District
'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
'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'
/state-judges:
get:
tags:
- Judges
summary: Get State Judges
description: 'Gets data on one or more single state judges.
- **stateJudgeIds**: the Lex Machina stateJudgeIds'
operationId: get_state_judges
security:
- JwtAccessBearer: []
parameters:
- name: stateJudgeIds
in: query
required: true
schema:
type: array
uniqueItems: true
items:
type: integer
minItems: 1
maxItems: 500
title: Statejudgeids
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/StateJudgeData'
title: Response Get State Judges State Judges Get
examples:
Multiple State Judges:
summary: Multiple State Judges
value:
- name: Sheila Abdus-Salaam
stateJudgeId: 2087
courtPosting: New York Supreme Court, New York County
- name: Daryl L Moore
stateJudgeId: 775
courtPosting: Texas District Court, 333rd Judicial District
'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
'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-judges:
get:
tags:
- Judges
summary: Search Judges
description: 'Searches for attorneys.
- **q**: the query string
This matches from the beginning of the last name. The search query "hof" will match the name "Hoffman" but will not match "Schofield".'
operationId: search_judges
security:
- JwtAccessBearer: []
parameters:
- name: q
in: query
required: true
schema:
type: string
title: Q
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/JudgeSearchResult'
examples:
Search Judges By Name:
summary: Search Judges By Name
value:
federalJudges: []
magistrateJudges:
- name: Leslie R Hoffman
magistrateJudgeId: 1144
caseCountByCourt:
- court: total
count: 2561
url: https://api.lexmachina.com/magistrate-judges/1144
- name: Carl William Hoffman
magistrateJudgeId: 407
caseCountByCourt:
- court: total
count: 5751
url: https://api.lexmachina.com/magistrate-judges/407
stateJudges:
- name: Douglas E Hoffman
stateJudgeId: 1125
courtPosting: New York Supreme Court, Bronx County
url: https://api.lexmachina.com/state-judges/1125
bankruptcyJudges:
- name: John E. Hoffman Jr.
bankruptcyJudgeId: 463
caseCountByCourt:
- court: total
count: 225
url: https://api.lexmachina.com/bankruptcy-judges/463
- name: Melvin S. Hoffman
bankruptcyJudgeId: 415
caseCountByCourt:
- court: total
count: 342
url: https://api.lexmachina.com/bankruptcy-judges/415
'422':
description: Error - 422
content:
application/json:
examples:
Invalid Query:
summary: Invalid Query
value:
detail: Empty query 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
'404':
description: Not found
content:
application/json:
examples:
Not found:
summary: Not found
value:
summary: Unknown id
detail: Not Found
components:
schemas:
StateJudgeData:
properties:
name:
type: string
title: Name
stateJudgeId:
type: integer
title: Statejudgeid
courtPosting:
type: string
title: Courtposting
additionalProperties: false
type: object
required:
- name
- stateJudgeId
- courtPosting
title: StateJudgeData
MagistrateJudgeResult:
properties:
name:
type: string
title: Name
magistrateJudgeId:
type: integer
title: Magistratejudgeid
caseCountByCourt:
items:
$ref: '#/components/schemas/CaseCountByCourt'
type: array
title: Casecountbycourt
url:
type: string
title: Url
additionalProperties: false
type: object
required:
- name
- magistrateJudgeId
- caseCountByCourt
- url
title: MagistrateJudgeResult
FederalJudgeData:
properties:
name:
type: string
title: Name
federalJudgeId:
type: integer
title: Federaljudgeid
initials:
type: string
title: Initials
dateOfBirth:
type: string
format: date
title: Dateofbirth
caseCountByCourt:
items:
$ref: '#/components/schemas/CaseCountByCourt'
type: array
title: Casecountbycourt
nominatingPresident:
anyOf:
- type: string
- type: 'null'
title: Nominatingpresident
additionalProperties: false
type: object
required:
- name
- federalJudgeId
- initials
- dateOfBirth
- caseCountByCourt
- nominatingPresident
title: FederalJudgeData
BankruptcyJudgeResult:
properties:
name:
type: string
title: Name
bankruptcyJudgeId:
type: integer
title: Bankruptcyjudgeid
caseCountByCourt:
items:
$ref: '#/components/schemas/CaseCountByCourt'
type: array
title: Casecountbycourt
url:
type: string
title: Url
additionalProperties: false
type: object
required:
- name
- bankruptcyJudgeId
- caseCountByCourt
- url
title: BankruptcyJudgeResult
FederalJudgeResult:
properties:
name:
type: string
title: Name
federalJudgeId:
type: integer
title: Federaljudgeid
initials:
type: string
title: Initials
caseCountByCourt:
items:
$ref: '#/components/schemas/CaseCountByCourt'
type: array
title: Casecountbycourt
url:
type: string
title: Url
additionalProperties: false
type: object
required:
- name
- federalJudgeId
- initials
- caseCountByCourt
- url
title: FederalJudgeResult
CaseCountByCourt:
properties:
court:
type: string
title: Court
count:
type: integer
title: Count
additionalProperties: false
type: object
required:
- court
- count
title: CaseCountByCourt
BankruptcyJudgeData:
properties:
name:
type: string
title: Name
bankruptcyJudgeId:
type: integer
title: Bankruptcyjudgeid
initials:
type: string
title: Initials
caseCountByCourt:
items:
$ref: '#/components/schemas/CaseCountByCourt'
type: array
title: Casecountbycourt
additionalProperties: false
type: object
required:
- name
- bankruptcyJudgeId
- initials
- caseCountByCourt
title: BankruptcyJudgeData
MagistrateJudgeData:
properties:
name:
type: string
title: Name
magistrateJudgeId:
type: integer
title: Magistratejudgeid
initials:
type: string
title: Initials
caseCountByCourt:
items:
$ref: '#/components/schemas/CaseCountByCourt'
type: array
title: Casecountbycourt
additionalProperties: false
type: object
required:
- name
- magistrateJudgeId
- initials
- caseCountByCourt
title: MagistrateJudgeData
StateJudgeResult:
properties:
name:
type: string
title: Name
stateJudgeId:
type: integer
title: Statejudgeid
courtPosting:
type: string
title: Courtposting
url:
type: string
title: Url
additionalProperties: false
type: object
required:
- name
- stateJudgeId
- courtPosting
- url
title: StateJudgeResult
JudgeSearchResult:
properties:
federalJudges:
items:
$ref: '#/components/schemas/FederalJudgeResult'
type: array
title: Federaljudges
magistrateJudges:
items:
$ref: '#/components/schemas/MagistrateJudgeResult'
type: array
title: Magistratejudges
stateJudges:
items:
$ref: '#/components/schemas/StateJudgeResult'
type: array
title: Statejudges
bankruptcyJudges:
items:
$ref: '#/components/schemas/BankruptcyJudgeResult'
type: array
title: Bankruptcyjudges
additionalProperties: false
type: object
required:
- federalJudges
- magistrateJudges
- stateJudges
- bankruptcyJudges
title: JudgeSearchResult
securitySchemes:
JwtAccessBearer:
type: http
scheme: bearer