Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/lex-machina-entities-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.1.0
info:
title: Lex Machina Alerts Entities API
version: '20260324'
description: Alerts.
servers:
- url: https://api.lexmachina.com
description: Lex Machina production API
tags:
- name: Entities
description: Entity data.
paths:
/attorneys/{attorney_id}:
get:
tags:
- Entities
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:
- Entities
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'
/bankruptcy-judges/{bankruptcy_judge_id}:
get:
tags:
- Entities
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:
- Entities
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:
- Entities
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:
- Entities
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'
/law-firms/{law_firm_id}:
get:
tags:
- Entities
summary: Get Law Firm
description: 'Gets data for a single law firm.
- **law_firm_id**: the Lex Machina lawFirmID'
operationId: get_law_firm
security:
- JwtAccessBearer: []
parameters:
- name: law_firm_id
in: path
required: true
schema:
type: integer
title: Law Firm Id
responses:
'200':
description: Success
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/LawFirmData'
- $ref: '#/components/schemas/LawFirmReference'
title: Response Get Law Firm Law Firms Law Firm Id Get
examples:
Single Lawfirm:
summary: Single Lawfirm
value:
name: Department of Justice
lawFirmId: 604
'404':
description: Not found
content:
application/json:
examples:
Lawfirm not found:
summary: Lawfirm not found
value:
detail: No law firm matching provided law firm ID was found
'422':
description: Error - 422
content:
application/json:
examples:
Invalid Input:
summary: Invalid Input
value:
detail:
- type: int_parsing
loc:
- path
- law_firm_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
/law-firms:
get:
tags:
- Entities
summary: Get Law Firms
description: 'Gets data for one or more law firms.
- **lawFirmIds**: the Lex Machina lawFirmIds
If any of the the lawFirmIds given are not the current lexmachina lawFirmId, the results will include inputId for disambugation'
operationId: get_law_firms
security:
- JwtAccessBearer: []
parameters:
- name: lawFirmIds
in: query
required: true
schema:
type: array
uniqueItems: true
items:
type: integer
minItems: 1
maxItems: 500
title: Lawfirmids
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
anyOf:
- $ref: '#/components/schemas/LawFirmData'
- $ref: '#/components/schemas/LawFirmReference'
title: Response Get Law Firms Law Firms Get
examples:
Successful Resolve:
summary: Successful Resolve
value:
- name: Department of Transportation
lawFirmId: 445928
- name: United States Department of Health & Human Services
lawFirmId: 382718
'404':
description: Not found
content:
application/json:
examples:
Law firms not found:
summary: Law firms not found
value:
detail: No law firms matching provided law firm 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'
/magistrate-judges/{magistrate_judge_id}:
get:
tags:
- Entities
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:
- Entities
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'
/parties/{party_id}:
get:
tags:
- Entities
summary: Get Party
description: 'Gets data for a single party.
- **party_id**: the Lex Machina partyId'
operationId: get_party
security:
- JwtAccessBearer: []
parameters:
- name: party_id
in: path
required: true
schema:
type: integer
title: Party Id
responses:
'200':
description: Success
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/PartyData'
- $ref: '#/components/schemas/PartyReference'
title: Response Get Party Parties Party Id Get
examples:
Single Party:
summary: Single Party
value:
name: Todd McFarlane
partyId: 196852
'404':
description: Not found
content:
application/json:
examples:
Party Not Found:
summary: Party Not Found
value:
detail: No party matching provided party ID was found
'422':
description: Error - 422
content:
application/json:
examples:
Invalid Input:
summary: Invalid Input
value:
detail:
- type: int_parsing
loc:
- path
- party_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
/parties:
get:
tags:
- Entities
summary: Get Parties
description: 'Gets data for one or more parties.
- **partyIds**: the Lex Machina partyIds
If any of the the partyIds given are not the current lexmachina partyId, the results will include inputId for disambugation'
operationId: get_parties
security:
- JwtAccessBearer: []
parameters:
- name: partyIds
in: query
required: true
schema:
type: array
uniqueItems: true
items:
type: integer
minItems: 1
maxItems: 500
title: Partyids
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
anyOf:
- $ref: '#/components/schemas/PartyData'
- $ref: '#/components/schemas/PartyReference'
title: Response Get Parties Parties Get
examples:
Multiple Parties:
summary: Multiple Parties
value:
- name: Todd McFarlane
partyId: 196852
- name: Stan Lee
partyId: 56391
'404':
description: Not found
content:
application/json:
examples:
Parties not found:
summary: Parties not found
value:
detail: No parties matching provided party 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:
- Entities
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: '#/component
# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lex-machina/refs/heads/main/openapi/lex-machina-entities-api-openapi.yml