Lex Machina Federal Appeals Cases API
Federal court of appeals 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-federal-appeals-cases-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Lex Machina Federal Appeals Cases API
version: '20260324'
description: Federal court of appeals cases.
servers:
- url: https://api.lexmachina.com
description: Lex Machina production API
tags:
- name: Federal Appeals Cases
description: Federal court of appeals cases.
paths:
/appeals-cases/{appeals_case_id}:
get:
tags:
- Federal Appeals Cases
summary: Get Appeals Case
description: 'Gets data for a single federal appeals circuit court case.
- **appeals_case_id**: the Lex Machina appealsCaseId'
operationId: get_appeals_case
security:
- JwtAccessBearer: []
parameters:
- name: appeals_case_id
in: path
required: true
schema:
type: integer
title: Appeals Case Id
- name: docket_retrieval
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
description: '''all'' to retrieve docket entries for the case, if not provided no docket entries will be retrieved.'
title: Docket Retrieval
description: '''all'' to retrieve docket entries for the case, if not provided no docket entries will be retrieved.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/AppealsCaseData'
examples:
single appeals court case:
summary: single appeals court case
value:
appealsCaseId: 2005396632
title: Apple Inc. v. Samsung Electronics Co., Ltd.
court: U.S. Court of Appeals for the Federal Circuit
civilActionNumber: 15-2088
status: Terminated
caseTags: []
dates:
filed: '2015-09-30'
terminated: '2015-10-13'
lastDocket: '2017-02-07'
judges:
- name: Kathleen McDonald O'Malley
federalJudgeId: 1800
- name: Sharon Prost
federalJudgeId: 2892
- name: Raymond T. Chen
federalJudgeId: 3486
lawFirms:
- name: WilmerHale
lawFirmId: 853
clientPartyIds:
- 2273
- name: Quinn Emanuel Urquhart & Sullivan
lawFirmId: 920
clientPartyIds:
- 2597
- 228037
- 3561
- 3564
- 30125
- 3801
- 123
- name: Morrison & Foerster
lawFirmId: 1934
clientPartyIds:
- 2273
attorneys:
- name: Brett Dylan Proctor
attorneyId: 24668
lawFirmIds:
- 920
clientsPartyIds:
- 3801
- 2597
- 228037
- 3561
- 123
- 3564
- 30125
- name: Michael Thomas Zeller
attorneyId: 51182
lawFirmIds:
- 920
clientsPartyIds:
- 3801
- 2597
- 228037
- 3561
- 123
- 3564
- 30125
- name: Rachel Krevans
attorneyId: 59516
lawFirmIds:
- 1934
clientsPartyIds:
- 2273
- name: Nathaniel Bryan Sabri
attorneyId: 136984
lawFirmIds:
- 1934
clientsPartyIds:
- 2273
- name: Victoria Fishman Maroulis
attorneyId: 149006
lawFirmIds:
- 920
clientsPartyIds:
- 3801
- 2597
- 228037
- 3561
- 123
- 3564
- 30125
- name: Lauren B. Fletcher
attorneyId: 389845
lawFirmIds:
- 853
clientsPartyIds:
- 2273
- name: Mark Daniel Selwyn
attorneyId: 516395
lawFirmIds:
- 853
clientsPartyIds:
- 2273
- name: Harold John McElhinny
attorneyId: 597589
lawFirmIds:
- 1934
clientsPartyIds:
- 2273
- name: Kathleen Marie Sullivan
attorneyId: 1134738
lawFirmIds:
- 920
clientsPartyIds:
- 3801
- 2597
- 228037
- 3561
- 123
- 3564
- 30125
- name: William Frank Lee
attorneyId: 1454279
lawFirmIds:
- 853
clientsPartyIds:
- 2273
- name: William Balden Adams
attorneyId: 2569613
lawFirmIds:
- 920
clientsPartyIds:
- 3801
- 2597
- 228037
- 3561
- 123
- 3564
- 30125
- name: Sarah R. Frazier
attorneyId: 2921843
lawFirmIds:
- 853
clientsPartyIds:
- 2273
- name: Erik Jeffrey Olson
attorneyId: 6398982
lawFirmIds:
- 1934
clientsPartyIds:
- 2273
- name: Mark Christopher Fleming
attorneyId: 89070821
lawFirmIds:
- 853
clientsPartyIds:
- 2273
- name: Thomas Gregory Sprankling
attorneyId: 107723076
lawFirmIds:
- 853
clientsPartyIds:
- 2273
parties:
- name: REUTERS AMERICA, LLC
partyId: 228037
role: Third Party
- name: RESEARCH IN MOTION CORPORATION
partyId: 3564
role: Third Party
- name: SAMSUNG ELECTRONICS CO., LTD.
partyId: 123
role: Appellant
- name: SAMSUNG TELECOMMUNICATIONS AMERICA, LLC
partyId: 30125
role: Appellant
- name: INTERNATIONAL BUSINESS MACHINES CORPORATION
partyId: 3801
role: Third Party
- name: SAMSUNG ELECTRONICS AMERICA, INC.
partyId: 2597
role: Appellant
- name: APPLE INC. (a California corporation)
partyId: 2273
role: Appellee
- name: RESEARCH IN MOTION, LTD.
partyId: 3561
role: Third Party
originatingVenues:
- 'Originating Venue: Federal District Court'
originatingCases:
- districtCaseId: 2000007922
districtCaseUrl: https://api.lexmachina.com/district-cases/2000007922
judges:
- name: Lucy Haeran Koh
federalJudgeId: 3279
caseTypes:
- Patent
- Trademark
- Contracts
- Antitrust
appealabilityRulings: []
caseResolution:
summary: Appellee Win
specific: Affirmed
docketEntryFiled: '2015-10-13'
supremeCourtAndRehearingDecisions: []
docket:
entries: []
retrieved: none
count: 41
'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'
/query-appeals-cases:
post:
tags:
- Federal Appeals Cases
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: []
components:
schemas:
AppealsPartyFilter:
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: AppealsPartyFilter
Ordering:
type: string
enum:
- ByFirstFiled
- ByLastFiled
title: Ordering
OriginatingVenuesFilter:
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: OriginatingVenuesFilter
AppealsCaseData:
properties:
appealsCaseId:
type: integer
title: Appealscaseid
title:
type: string
title: Title
court:
type: string
title: Court
civilActionNumber:
type: string
title: Civilactionnumber
status:
$ref: '#/components/schemas/CaseStatus'
caseTags:
items:
type: string
type: array
title: Casetags
dates:
$ref: '#/components/schemas/AppealsCaseDates'
judges:
items:
$ref: '#/components/schemas/FederalJudge'
type: array
title: Judges
lawFirms:
items:
$ref: '#/components/schemas/LawFirm'
type: array
title: Lawfirms
attorneys:
items:
$ref: '#/components/schemas/Attorney'
type: array
title: Attorneys
parties:
items:
$ref: '#/components/schemas/Party'
type: array
title: Parties
originatingVenues:
items:
type: string
type: array
title: Originatingvenues
originatingCases:
items:
$ref: '#/components/schemas/OriginatingDistrictCourtCase'
type: array
title: Originatingcases
appealabilityRulings:
items:
type: string
type: array
title: Appealabilityrulings
caseResolution:
anyOf:
- $ref: '#/components/schemas/CaseResolution'
- type: 'null'
supremeCourtAndRehearingDecisions:
items:
$ref: '#/components/schemas/SupremeCourtOrRehearingDecision'
type: array
title: Supremecourtandrehearingdecisions
docket:
$ref: '#/components/schemas/Docket'
additionalProperties: false
type: object
required:
- appealsCaseId
- title
- court
- civilActionNumber
- status
- caseTags
- dates
- judges
- lawFirms
- attorneys
- parties
- originatingVenues
- originatingCases
- appealabilityRulings
- supremeCourtAndRehearingDecisions
- docket
title: AppealsCaseData
description: A single case from a federal district appeals court case and relevant metadata.
OriginatingJudgeFilter:
properties:
districtFederalJudges:
anyOf:
- $ref: '#/components/schemas/JudgeFilter'
- type: 'null'
additionalProperties: false
type: object
title: OriginatingJudgeFilter
SupremeCourtOrRehearingDecision:
properties:
docketEntryFiled:
type: string
format: date
title: Docketentryfiled
decision:
type: string
title: Decision
originalResolutionDocketEntryFiled:
anyOf:
- type: string
format: date
- type: 'null'
title: Originalresolutiondocketentryfiled
originalResolution:
anyOf:
- type: string
- type: 'null'
title: Originalresolution
additionalProperties: false
type: object
required:
- docketEntryFiled
- decision
title: SupremeCourtOrRehearingDecision
AppealsCaseDatesFilter:
properties:
filed:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
terminated:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
lastDocket:
anyOf:
- $ref: '#/components/schemas/TimingFilter'
- type: 'null'
additionalProperties: false
type: object
title: AppealsCaseDatesFilter
DocketEntry:
properties:
filedOn:
anyOf:
- type: string
format: date
- type: 'null'
title: Filedon
tags:
items:
type: string
type: array
title: Tags
text:
anyOf:
- type: string
- type: 'null'
title: Text
number:
anyOf:
- type: integer
- type: 'null'
title: Number
docketEntryId:
type: integer
title: Docketentryid
additionalProperties: false
type: object
required:
- filedOn
- tags
- text
- number
- docketEntryId
title: DocketEntry
OriginatingDistrictCourtCase:
properties:
districtCaseId:
type: integer
title: Districtcaseid
districtCaseUrl:
type: string
title: Districtcaseurl
judges:
items:
anyOf:
- $ref: '#/components/schemas/FederalJudge'
- $ref: '#/components/schemas/MagistrateJudge'
type: array
title: Judges
caseTypes:
items:
type: string
type: array
title: Casetypes
additionalProperties: false
type: object
required:
- districtCaseId
- districtCaseUrl
- judges
- caseTypes
title: OriginatingDistrictCourtCase
Attorney:
properties:
name:
type: string
title: Name
attorneyId:
type: integer
title: Attorneyid
lawFirmIds:
items:
type: integer
type: array
uniqueItems: true
title: Lawfirmids
clientsPartyIds:
items:
type: integer
type: array
uniqueItems: true
title: Clientspartyids
additionalProperties: false
type: object
required:
- name
- attorneyId
- lawFirmIds
- clientsPartyIds
title: Attorney
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
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
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
AppealsCaseQueryResult:
properties:
cases:
items:
$ref: '#/components/schemas/AppealsCaseReference'
type: array
title: Cases
additionalProperties: false
type: object
required:
- cases
title: AppealsCaseQueryResult
AppealsCaseReference:
properties:
url:
type: string
title: Url
appealsCaseId:
type: integer
title: Appealscaseid
additionalProperties: false
type: object
required:
- url
- appealsCaseId
title: AppealsCaseReference
OriginatingCaseTypesFilter:
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: OriginatingCaseTypesFilter
DocketEntriesIncludedInOutput:
type: string
enum:
- all
- none
title: DocketEntriesIncludedInOutput
OriginatingDistrictCaseFilter:
properties:
courts:
anyOf:
- $ref: '#/components/schemas/CourtFilter'
- type: 'null'
caseTypes:
anyOf:
- $ref: '#/components/schemas/OriginatingCaseTypesFilter'
- type: 'null'
additionalProperties: false
type: object
title: OriginatingDistrictCaseFilter
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: obje
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lex-machina/refs/heads/main/openapi/lex-machina-federal-appeals-cases-api-openapi.yml