Lex Machina Case Query API
Provides a filter based way to find cases.
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-case-query-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 Case Query API
version: '20260324'
description: Alerts.
servers:
- url: https://api.lexmachina.com
description: Lex Machina production API
tags:
- name: Case Query
description: Provides a filter based way to find cases.
paths:
/query-appeals-cases:
post:
tags:
- Case Query
summary: Query Appeals Cases
description: 'Queries federal appeals court cases.
- **data**: the appeals case query
See [https://developer.lexmachina.com/posts/query/appeals_query_usage/](https://developer.lexmachina.com/posts/query/appeals_query_usage/) for query formation.
The results will contain a list of cases, each with a specificed url and Lex Machina appealsCaseId.'
operationId: query_appeals_cases
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AppealsCaseQuery'
examples:
appeals query on originating venue:
summary: appeals query on originating venue
description: appeals cases originating in the court of federal claims
value: '{"originatingVenues": {"include": ["Originating Venue: Court of Federal Claims"]}}'
appeals query on court:
summary: appeals query on court
description: appeals cases in the tenth circuit
value: '{"courts": {"include": ["U.S. Court of Appeals for the Tenth Circuit"]}}'
required: true
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/AppealsCaseQueryResult'
examples:
appeals query on originating venue:
summary: appeals query on originating venue
value:
cases:
- url: https://api.lexmachina.com/appeals-cases/2005670885
appealsCaseId: 2005670885
- url: https://api.lexmachina.com/appeals-cases/2005670259
appealsCaseId: 2005670259
- url: https://api.lexmachina.com/appeals-cases/2005670890
appealsCaseId: 2005670890
- url: https://api.lexmachina.com/appeals-cases/2005668241
appealsCaseId: 2005668241
- url: https://api.lexmachina.com/appeals-cases/2005670690
appealsCaseId: 2005670690
appeals query on court:
summary: appeals query on court
value:
cases:
- url: https://api.lexmachina.com/appeals-cases/2005756070
appealsCaseId: 2005756070
- url: https://api.lexmachina.com/appeals-cases/2005821468
appealsCaseId: 2005821468
- url: https://api.lexmachina.com/appeals-cases/2005835286
appealsCaseId: 2005835286
- url: https://api.lexmachina.com/appeals-cases/2005840529
appealsCaseId: 2005840529
- url: https://api.lexmachina.com/appeals-cases/2005866923
appealsCaseId: 2005866923
'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'
security:
- JwtAccessBearer: []
/query-district-cases:
post:
tags:
- Case Query
summary: Query District Cases
description: 'Queries federal district court cases.
- **data**: the district case query
See [Querying district cases](https://developer.lexmachina.com/api-reference/district-cases/querying-district-cases/) for documentation.
The results will contain a list of cases, each with a specificed url and Lex Machina districtCaseId.'
operationId: query_district_cases
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/DistrictCaseQuery'
examples:
three district query results:
summary: three district query results
description: contracts cases in district of NJ in 2021
value: '{"courts": {"include": ["njd"]}, "caseTypes": {"include": ["Contracts"]}, "dates": {"filed": {"onOrAfter": "2019-01-01", "onOrBefore": "2019-12-31"}, "terminated": {"onOrAfter": "2021-01-01", "onOrBefore": "2021-12-31"}}, "page": 1, "pageSize": 3}'
required: true
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DistrictCaseQueryResult'
examples:
three district query results:
summary: three district query results
value:
cases:
- url: https://api.lexmachina.com/district-cases/2002259499
districtCaseId: 2002259499
- url: https://api.lexmachina.com/district-cases/2002265866
districtCaseId: 2002265866
- url: https://api.lexmachina.com/district-cases/2002268016
districtCaseId: 2002268016
'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'
security:
- JwtAccessBearer: []
/query-state-cases:
post:
tags:
- Case Query
summary: Query State Cases
description: 'Queries enhanced state court cases.
- **data**: the state case query
See [https://developer.lexmachina.com/posts/query/state_query_usage/](https://developer.lexmachina.com/posts/query/state_query_usage/) for query formation.
The results will contain a list of cases, each with a specificed url and Lex Machina stateCaseId.'
operationId: query_state_cases
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/StateCaseQuery'
required: true
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/StateCaseQueryResult'
examples:
Query Results:
summary: Query Results
value:
cases:
- url: https://api.lexmachina.com/state-cases/2003442290
stateCaseId: 2003442290
- url: https://api.lexmachina.com/state-cases/2003442348
stateCaseId: 2003442348
- url: https://api.lexmachina.com/state-cases/2003442352
stateCaseId: 2003442352
- url: https://api.lexmachina.com/state-cases/2003463384
stateCaseId: 2003463384
- url: https://api.lexmachina.com/state-cases/2003442446
stateCaseId: 2003442446
'422':
description: Error - 422
content:
application/json:
examples:
Maximum Cases Per Page Exceeded:
summary: Maximum Cases Per Page Exceeded
value:
detail: Maximum cases per page is 100
Invalid Input:
summary: Invalid Input
value:
detail:
- type: missing
loc:
- body
- courts
- state
msg: Field required
input:
include:
- Fort Bend County District Court
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
security:
- JwtAccessBearer: []
components:
schemas:
JudgmentSourceFilter:
properties:
include:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
title: JudgmentSourceFilter
AppealsCaseQuery:
properties:
courts:
anyOf:
- $ref: '#/components/schemas/CourtFilter'
- type: 'null'
caseStatus:
anyOf:
- $ref: '#/components/schemas/CaseStatus'
- type: 'null'
caseTags:
anyOf:
- $ref: '#/components/schemas/CaseTagsFilter'
- type: 'null'
dates:
anyOf:
- $ref: '#/components/schemas/AppealsCaseDatesFilter'
- type: 'null'
judges:
anyOf:
- $ref: '#/components/schemas/JudgeFilter'
- type: 'null'
lawFirms:
anyOf:
- $ref: '#/components/schemas/AppealsLawFirmFilter'
- type: 'null'
attorneys:
anyOf:
- $ref: '#/components/schemas/AppealsAttorneyFilter'
- type: 'null'
parties:
anyOf:
- $ref: '#/components/schemas/AppealsPartyFilter'
- type: 'null'
originatingVenues:
anyOf:
- $ref: '#/components/schemas/OriginatingVenuesFilter'
- type: 'null'
originatingCases:
anyOf:
- $ref: '#/components/schemas/OriginatingCasesFilter'
- type: 'null'
resolutions:
anyOf:
- $ref: '#/components/schemas/ResolutionsFilter'
- type: 'null'
supremeCourtDecisions:
anyOf:
- $ref: '#/components/schemas/SupremeCourtDecisionsFilter'
- type: 'null'
ordering:
$ref: '#/components/schemas/Ordering'
default: ByFirstFiled
page:
type: integer
title: Page
default: 1
pageSize:
type: integer
title: Pagesize
default: 5
additionalProperties: false
type: object
title: AppealsCaseQuery
DistrictCaseReference:
properties:
url:
type: string
title: Url
districtCaseId:
type: integer
title: Districtcaseid
additionalProperties: false
type: object
required:
- url
- districtCaseId
title: DistrictCaseReference
StateCaseQuery:
properties:
courts:
$ref: '#/components/schemas/StateCourtFilter'
caseStatus:
anyOf:
- $ref: '#/components/schemas/CaseStatus'
- type: 'null'
caseTypes:
anyOf:
- $ref: '#/components/schemas/CaseTypesFilter'
- type: 'null'
caseTags:
anyOf:
- $ref: '#/components/schemas/CaseTagsFilter'
- type: 'null'
dates:
anyOf:
- $ref: '#/components/schemas/CaseDatesFilter'
- type: 'null'
judges:
anyOf:
- $ref: '#/components/schemas/JudgeFilter'
- type: 'null'
events:
anyOf:
- $ref: '#/components/schemas/EventFilter'
- type: 'null'
lawFirms:
anyOf:
- $ref: '#/components/schemas/LawFirmFilter'
- type: 'null'
attorneys:
anyOf:
- $ref: '#/components/schemas/AttorneyFilter'
- type: 'null'
parties:
anyOf:
- $ref: '#/components/schemas/PartyFilter'
- type: 'null'
resolutions:
anyOf:
- $ref: '#/components/schemas/ResolutionsFilter'
- type: 'null'
damages:
anyOf:
- items:
$ref: '#/components/schemas/IndividualStateDamagesFilter'
type: array
- type: 'null'
title: Damages
rulings:
anyOf:
- items:
$ref: '#/components/schemas/IndividualRulingsFilter'
type: array
- type: 'null'
title: Rulings
ordering:
$ref: '#/components/schemas/Ordering'
default: ByFirstFiled
page:
type: integer
title: Page
default: 1
pageSize:
type: integer
title: Pagesize
default: 5
additionalProperties: false
type: object
required:
- courts
title: StateCaseQuery
example:
caseStatus: Terminated
courts:
include:
- Fort Bend County District Court
state: TX
dates:
filed:
onOrAfter: '2016-01-01'
terminated:
onOrBefore: '2021-05-01'
judges:
include:
- 1792
ordering: ByFirstFiled
page: 1
pageSize: 5
StateCaseReference:
properties:
url:
type: string
title: Url
stateCaseId:
type: integer
title: Statecaseid
additionalProperties: false
type: object
required:
- url
- stateCaseId
title: StateCaseReference
TimingFilter:
properties:
onOrAfter:
anyOf:
- type: string
format: date
- type: 'null'
title: Onorafter
onOrBefore:
anyOf:
- type: string
format: date
- type: 'null'
title: Onorbefore
additionalProperties: false
type: object
title: TimingFilter
CaseDatesFilter:
properties:
filed:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
terminated:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
trial:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
lastDocket:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
additionalProperties: false
type: object
title: CaseDatesFilter
IndividualNameTypeFilter:
properties:
name:
anyOf:
- type: string
- type: 'null'
title: Name
type:
anyOf:
- type: string
- type: 'null'
title: Type
additionalProperties: false
type: object
title: IndividualNameTypeFilter
NameTypeFilter:
properties:
include:
anyOf:
- items:
$ref: '#/components/schemas/IndividualNameTypeFilter'
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
$ref: '#/components/schemas/IndividualNameTypeFilter'
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
title: NameTypeFilter
IndividualStateDamagesFilter:
properties:
name:
anyOf:
- $ref: '#/components/schemas/NameFilter'
- type: 'null'
date:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
awardedToParties:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Awardedtoparties
awardedAgainstParties:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Awardedagainstparties
minimumAmount:
anyOf:
- type: number
- type: string
pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- type: 'null'
title: Minimumamount
additionalProperties: false
type: object
title: IndividualStateDamagesFilter
AppellateDecisionFilter:
properties:
include:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
title: AppellateDecisionFilter
MultidistrictLitigationFilter:
properties:
include:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: integer
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
title: MultidistrictLitigationFilter
CaseStatus:
type: string
enum:
- Open
- Terminated
title: CaseStatus
AppealsLawFirmFilter:
properties:
include:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Exclude
includeAppellant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includeappellant
excludeAppellant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludeappellant
includeAppellee:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includeappellee
excludeAppellee:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludeappellee
includeRespondent:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includerespondent
excludeRespondent:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excluderespondent
includeThirdParty:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includethirdparty
excludeThirdParty:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludethirdparty
includePetitionerMovant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includepetitionermovant
excludePetitionerMovant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludepetitionermovant
additionalProperties: false
type: object
title: AppealsLawFirmFilter
Ordering:
type: string
enum:
- ByFirstFiled
- ByLastFiled
title: Ordering
OriginatingCasesFilter:
properties:
includeDistrictCaseIds:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includedistrictcaseids
excludeDistrictCaseIds:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludedistrictcaseids
includeOriginatingJudges:
anyOf:
- $ref: '#/components/schemas/OriginatingJudgeFilter'
- type: 'null'
originatingDistrictCaseCriteria:
anyOf:
- $ref: '#/components/schemas/OriginatingDistrictCaseFilter'
- type: 'null'
additionalProperties: false
type: object
title: OriginatingCasesFilter
JudgmentEventFilter:
properties:
include:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
title: JudgmentEventFilter
AppealsAttorneyFilter:
properties:
include:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Exclude
includeAppellant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includeappellant
excludeAppellant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludeappellant
includeAppellee:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includeappellee
excludeAppellee:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludeappellee
includeRespondent:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includerespondent
excludeRespondent:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excluderespondent
includeThirdParty:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includethirdparty
excludeThirdParty:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludethirdparty
includePetitionerMovant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includepetitionermovant
excludePetitionerMovant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludepetitionermovant
additionalProperties: false
type: object
title: AppealsAttorneyFilter
LawFirmFilter:
properties:
include:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Exclude
includePlaintiff:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includeplaintiff
excludePlaintiff:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludeplaintiff
includeDefendant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includedefendant
excludeDefendant:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludedefendant
includeThirdParty:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Includethirdparty
excludeThirdParty:
anyOf:
- items:
type: integer
exclusiveMaximum: 2147483647.0
exclusiveMinimum: 0.0
type: array
- type: 'null'
title: Excludethirdparty
additionalProperties: false
type: object
title: LawFirmFilter
ResolutionsFilter:
properties:
include:
anyOf:
- items:
$ref: '#/components/schemas/IndividualResolutionsFilter'
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
$ref: '#/components/schemas/IndividualResolutionsFilter'
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
title: ResolutionsFilter
CourtFilter:
properties:
include:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
title: CourtFilter
OriginatingDistrictCaseFilter:
properties:
courts:
anyOf:
- $ref: '#/components/schemas/CourtFilter'
- type: 'null'
caseTypes:
anyOf:
- $ref: '#/components/schemas/OriginatingCaseTypesFilter'
- type: 'null'
additionalProperties: false
type: object
title: OriginatingDistrictCaseFilter
StateCourtFilter:
properties:
state:
type: string
title: State
include:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Include
exclude:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Exclude
additionalProperties: false
type: object
required:
- state
title: StateCourtFilter
PatentInvalidityReasonsFilter:
properties:
include:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Include
additionalProperties: f
# --- truncated at 32 KB (52 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lex-machina/refs/heads/main/openapi/lex-machina-case-query-api-openapi.yml