Lex Machina List API

Provides cannonical lists for specific fields.

OpenAPI Specification

lex-machina-list-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Lex Machina Alerts List API
  version: '20260324'
  description: Alerts.
servers:
- url: https://api.lexmachina.com
  description: Lex Machina production API
tags:
- name: List
  description: Provides cannonical lists for specific fields.
paths:
  /list-appealability-rulings:
    get:
      tags:
      - List
      summary: List Appealability Rulings
      description: Lists appealability rulings for use with appeals case querying.
      operationId: list_appealability_rulings
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema: {}
              examples:
                List of Valid Appealability Rulings:
                  summary: List of Valid Appealability Rulings
                  value:
                  - 'Permission to Appeal: Grant'
                  - 'Permission to Appeal: Deny'
                  - 'Certificate of Appealability: Grant'
                  - 'Certificate of Appealability: Deny'
                  - 'Petition for Review: Grant'
                  - 'Petition for Review: Deny'
        '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: []
  /list-appellate-decisions/FederalDistrict:
    get:
      tags:
      - List
      summary: List Appellate Decisions
      description: Lists appellate decisions for use with appeals case querying.
      operationId: list_appellate_decisions
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                items:
                  type: string
                type: array
                title: Response List Appellate Decisions List Appellate Decisions Federaldistrict Get
              examples:
                FederalDistrict List of Valid Appellate Decisions:
                  summary: FederalDistrict List of Valid Appellate Decisions
                  value:
                  - Affirmed
                  - Affirmed / Reversed in Part
                  - Reversed
        '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: []
  /list-case-resolutions/{court_type}:
    get:
      tags:
      - List
      summary: List Case Resolutions
      description: 'Lists case resolutions given court type for use with querying.


        - **court_type**: the relevant court type


        Each resoltuon has both a summary and specific field which are valid in combinations listed.'
      operationId: list_case_resolutions
      security:
      - JwtAccessBearer: []
      parameters:
      - name: court_type
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/CourtType'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CaseResolutionsList'
              examples:
                List Of Valid Case Resolutions For FederalDistrict:
                  summary: List Of Valid Case Resolutions For FederalDistrict
                  value:
                    court:
                      name: All Federal District Courts
                      type: FederalDistrict
                    caseResolutions:
                    - summary: Claimant Win
                      specific: Summary Judgment
                    - summary: Claimant Win
                      specific: Default Judgment
                    - summary: Claimant Win
                      specific: Consent Judgment
                    - summary: Claimant Win
                      specific: Trial
                    - summary: Claimant Win
                      specific: Judgment on the Pleadings
                    - summary: Claimant Win
                      specific: Decision on Bankruptcy Appeal
                    - summary: Claimant Win
                      specific: Judgment as a Matter of Law
                    - summary: Claim Defendant Win
                      specific: Judgment as a Matter of Law
                    - summary: Claim Defendant Win
                      specific: Summary Judgment
                    - summary: Claim Defendant Win
                      specific: Default Judgment
                    - summary: Claim Defendant Win
                      specific: Consent Judgment
                    - summary: Claim Defendant Win
                      specific: Trial
                    - summary: Claim Defendant Win
                      specific: Judgment on the Pleadings
                    - summary: Claim Defendant Win
                      specific: Decision on Bankruptcy Appeal
                    - summary: Likely Settlement
                      specific: Class Action Settlement
                    - summary: Likely Settlement
                      specific: Likely Settlement
                    - summary: Procedural
                      specific: Interdistrict Transfer
                    - summary: Procedural
                      specific: Consolidation
                    - summary: Procedural
                      specific: Multidistrict Litigation
                    - summary: Procedural
                      specific: Severance
                    - summary: Procedural
                      specific: Contested Dismissal
                    - summary: Procedural
                      specific: Stay
                    - summary: Procedural
                      specific: Sealed
                    - summary: Procedural
                      specific: Dismissal
                    - summary: Procedural
                      specific: Intradistrict Transfer
                    - summary: Procedural
                      specific: Appeal Pending
                List Of Valid Case Resolutions For State:
                  summary: List Of Valid Case Resolutions For State
                  value:
                    court:
                      name: All State Courts
                      type: State
                    caseResolutions:
                    - summary: Plaintiff Win
                      specific: Other Judgment
                    - summary: Plaintiff Win
                      specific: Default Judgment
                    - summary: Plaintiff Win
                      specific: Consent Judgment
                    - summary: Plaintiff Win
                      specific: Bench Trial
                    - summary: Plaintiff Win
                      specific: Jury Verdict
                    - summary: Defendant Win
                      specific: Bench Trial
                    - summary: Defendant Win
                      specific: Jury Verdict
                    - summary: Defendant Win
                      specific: Other Judgment
                    - summary: Defendant Win
                      specific: Default Judgment
                    - summary: Defendant Win
                      specific: Consent Judgment
                    - summary: Likely Settlement
                      specific: Likely Settlement
                    - summary: Procedural
                      specific: Procedural
                    - summary: Indeterminable
                      specific: Indeterminable
        '422':
          description: Error - 422
          content:
            application/json:
              examples:
                Invalid Input:
                  summary: Invalid Input
                  value:
                    detail:
                    - type: enum
                      loc:
                      - path
                      - court_type
                      msg: Input should be 'FederalDistrict', 'State', 'FederalAppeals', 'FederalBankruptcy', 'PTAB' or 'ITC'
                      input: string
                      ctx:
                        expected: '''FederalDistrict'', ''State'', ''FederalAppeals'', ''FederalBankruptcy'', ''PTAB'' or ''ITC'''
                Unsupported Court Type:
                  summary: Unsupported Court Type
                  value:
                    detail: Case Resolutions not used for ITC
                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
  /list-case-tags/{court_type}:
    get:
      tags:
      - List
      summary: List Case Tags
      description: 'Lists case tags for a given court type for use with querying.


        - **court_type**: the relevant court type'
      operationId: list_case_tags
      security:
      - JwtAccessBearer: []
      parameters:
      - name: court_type
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/CourtType'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CaseTagsList'
                title: Response List Case Tags List Case Tags  Court Type  Get
              examples:
                List Of Valid Case Tags For FederalDistrict:
                  summary: List Of Valid Case Tags For FederalDistrict
                  value:
                  - court:
                      name: All Federal District Courts
                      type: FederalDistrict
                    caseTags:
                    - Design Patent
                    - Motor Vehicle
                    - Premises Liability
                    - Federal Tort Claims Act
                    - Trial
                    - COVID-19
                    - 'Mass Tort: Deepwater Horizon'
                    - 'Mass Tort: Doe Run Resources'
                    - 'Mass Tort: World Trade Center'
                    - State Employment Claim
                    - Admiralty / Maritime
                    - ADA (Civil Rights)
                    - Police Action
                    - 'Data: Personally Identifiable Information'
                    - Business Interruption
                    - 'Data: Protected Health Information'
                    - Declaratory Judgment (IP)
                    - Appealed
                    - 'Order re: Summary Judgment'
                    - ANDA
                    - SCOTUS Decision
                    - CFAA
                    - ECPA
                    - DMCA
                    - Retaliation (False Claims)
                    - Fair Housing Act
                    - Foreclosure
                    - Rent / Lease / Ejectment
                    - Torts to Land
                    - Land Condemnation
                    - Bench Trial
                    - Jury Trial
                    - Claim Construction Hearing
                    - 'ADA: Auditory / Visual Accommodation'
                    - 'ADA: Mobility Accommodation'
                    - 'ADA: Service Animal Accommodation'
                    - 'ADA: Website Access Accommodation'
                    - ADA High-Volume Plaintiff
                    - USA Filed (False Claims)
                    - Healthcare (False Claims)
                    - Government Contract (False Claims)
                    - Qui Tam (False Claims)
                    - Voting
                    - Education
                    - First Amendment
                    - Consumer Fraud
                    - Equitable Subrogation
                    - Counterfeiting
                    - Non-Compete
                    - Biometric Privacy
                    - Pro Se
                    - 'Order re: Expert Admissibility'
                    - APA
                    - File Sharing
                    - Cybersquatting
                    - Derivative Suit
                    - Dilution
                    - Commodity Exchange Act
                    - Section 11 / 12
                    - Section 14
                    - Section 20(a)
                    - Class Action
                    - Government Plaintiff
                    - 'SEC Enforcement: Settled Complaint'
                    - Securities Fraud (§ 10(b) / 10b-5)
                    - 'SEC Enforcement: Contested'
                    - 'DOJ/FTC Enforcement: Contested'
                    - 'DOJ/FTC Enforcement: Administrative'
                    - Robinson-Patman Act
                    - 'Order re: Dismiss (Contested)'
                    - 'Order re: Class Certification'
                    - MDL Master Case
                    - MDL Associated Case
                    - Commercial
                    - Discrimination (Federal)
                    - Retaliation (Federal)
                    - Harassment (Federal)
                    - Miller Act
                    - Accommodation (Federal)
                    - Chapter 11
                    - Adversary Proceeding
                    - Proposed FFCL (28 U.S.C. § 157(c)(1))
                    - Withdrawal of the Reference
                    - Bankruptcy Appeal
                    - High-Volume Plaintiff
                    - Business Tort
                    - Removal
                    - 'Product: Aircraft'
                    - 'Product: Asbestos'
                    - 'Product: Vehicle'
                    - Warranty / Economic Loss
                    - Chapter 7
                    - Chapter 13
                    - Business Debtor
                    - Individual Debtor
                    - ADA (Employment)
                    - Subrogation (Product Liability)
                    - Chapter 9
                    - Chapter 12
                    - Chapter 15
                    - FMLA
                    - FLSA
                    - EEOC Charging Party
                    - 'Product: Medical Device / Pharmaceutical'
                    - FLSA Collective Action
                    - 'Order re: FLSA Conditional Certification'
                    - Defend Trade Secrets Act
                    - Schedule A Defendants
                    - Hurricane Related
                    - UM / UIM
                    - 'Policy: Auto'
                    - 'Policy: Business Liability'
                    - 'Policy: Homeowners'
                    - 'Policy: Life'
                    - Claim Denial (ERISA)
                    - Delinquent Contribution (ERISA)
                    - Plan Reimbursement
                    - Withdrawal Liability (ERISA)
                    - Franchise Agreement
                    - Negotiable Instrument
                    - Breach of Contract
                    - 'Data: Financial Records'
                    - Non-Commercial
                    - RICO
                    - Forfeiture / Penalty
                    - Immigration
                    - 'Mass Tort: DuPont C-8'
                    - FTC / CFPB Enforcement
                    - Fair Credit Reporting Act
                    - Fair Debt Collection Practices Act
                    - Real Estate Settlement Procedures Act
                    - Truth In Lending Act
                    - Unfair / Deceptive Trade Practices
                    - Telephone Consumer Protection Act
                    - Data Breach
                    - CERCLA
                    - Clean Water Act
                    - Clean Air Act
                    - Endangered Species Act
                    - RCRA
                    - NEPA
                    - Partnership Items
                    - IRS Summons
                    - Tax Preparer Penalty
                    - Deepwater Horizon
                    - FOIA
                    - Medical Malpractice
                List Of Valid Case Tags For State:
                  summary: List Of Valid Case Tags For State
                  value:
                  - court:
                      name: Los Angeles County Superior Court
                      type: State
                      state: CA
                    caseTags:
                    - General Jurisdiction
                    - Limited Jurisdiction
                    - CRC 3.4 Complex
                    - Collections (CA)
                    - Trial
                    - PAGA
                  - court:
                      name: Harris County District Court
                      type: State
                      state: TX
                    caseTags:
                    - 'Order re: Summary Judgment'
                    - Jury
                    - Trial
                  - court:
                      name: Harris County Court
                      type: State
                      state: TX
                    caseTags:
                    - 'Order re: Summary Judgment'
                    - Jury
                    - Trial
                  - court:
                      name: Court of Chancery
                      type: State
                      state: DE
                    caseTags:
                    - Breach of Contract (DCC)
                    - Breach of Fiduciary Duties (DCC)
                    - Class Action
                    - Complaint - Inspection of Books & Records (DCC)
                    - Contract (DCC)
                    - Appraisal (DCC)
                    - Declaratory Judgment (DCC)
                    - Dissolution (DCC)
                    - Trial
                    - Injunctive Relief (DCC)
                    - Specific Performance (DCC)
                    - Civil Action (DCC)
                    - Accounting (DCC)
                  - court:
                      name: Fort Bend County Court
                      type: State
                      state: TX
                    caseTags:
                    - 'Order re: Summary Judgment'
                    - Jury
                    - Trial
                  - court:
                      name: Fort Bend County District Court
                      type: State
                      state: TX
                    caseTags:
                    - 'Order re: Summary Judgment'
                    - Jury
                    - Trial
                  - court:
                      name: Sacramento County Superior Court
                      type: State
                      state: CA
                    caseTags:
                    - General Jurisdiction
                    - Limited Jurisdiction
                    - CRC 3.4 Complex
                    - Collections (CA)
                    - Trial
                    - PAGA
                  - court:
                      name: San Bernardino County Superior Court
                      type: State
                      state: CA
                    caseTags:
                    - General Jurisdiction
                    - Limited Jurisdiction
                    - CRC 3.4 Complex
                    - Collections (CA)
                    - Trial
                    - PAGA
                  - court:
                      name: Riverside County Superior Court
                      type: State
                      state: CA
                    caseTags:
                    - General Jurisdiction
                    - Limited Jurisdiction
                    - CRC 3.4 Complex
                    - Collections (CA)
                    - Trial
                    - PAGA
                  - court:
                      name: Orange County Superior Court
                      type: State
                      state: CA
                    caseTags:
                    - General Jurisdiction
                    - Limited Jurisdiction
                    - CRC 3.4 Complex
                    - Collections (CA)
                    - Trial
                    - PAGA
                  - court:
                      name: Clark County District Court
                      type: State
                      state: NV
                    caseTags:
                    - Trial
                    - Jury
                  - court:
                      name: San Diego County Superior Court
                      type: State
                      state: CA
                    caseTags:
                    - General Jurisdiction
                    - Limited Jurisdiction
                    - CRC 3.4 Complex
                    - Collections (CA)
                    - Trial
                    - PAGA
                  - court:
                      name: King County Superior Court
                      type: State
                      state: WA
                    caseTags:
                    - Trial
                    - Collections (WA)
                  - court:
                      name: DeKalb County Superior Court
                      type: State
                      state: GA
                    caseTags:
                    - Medical Malpractice (GA)
                    - 'Order re: Summary Judgment'
                    - Class Action
                    - Collections (GA)
                    - Special Master (GA)
                    - Trial
                  - court:
                      name: DeKalb County State Court
                      type: State
                      state: GA
                    caseTags:
                    - Medical Malpractice (GA)
                    - 'Order re: Summary Judgment'
                    - Class Action
                    - Collections (GA)
                    - Trial
                  - court:
                      name: Fulton County Superior Court
                      type: State
                      state: GA
                    caseTags:
                    - Medical Malpractice (GA)
                    - 'Order re: Summary Judgment'
                    - Class Action
                    - Collections (GA)
                    - Special Master (GA)
                    - Trial
                  - court:
                      name: Fulton County State Court
                      type: State
                      state: GA
                    caseTags:
                    - Medical Malpractice (GA)
                    - 'Order re: Summary Judgment'
                    - Class Action
                    - Collections (GA)
                    - Special Master (GA)
                    - Trial
                  - court:
                      name: Alameda County Superior Court
                      type: State
                      state: CA
                    caseTags:
                    - General Jurisdiction
                    - Limited Jurisdiction
                    - CRC 3.4 Complex
                    - Collections (CA)
                    - Trial
                    - PAGA
                  - court:
                      name: Multnomah County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Benton County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Clackamas County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Deschutes County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Jackson County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Lane County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Linn County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Marion County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Washington County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Baker County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Clatsop County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Columbia County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Coos County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Crook County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Curry County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Douglas County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Gilliam County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Grant County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Harney County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Hood River County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Jefferson County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Josephine County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Klamath County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Lake County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Lincoln County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Malheur County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Morrow County Circuit Court
                      type: State
                      state: OR
                    caseTags:
                    - Trial
                    - Collections (OR)
                  - court:
                      name: Polk County Circuit Court
                      type: State
                      state: OR
              

# --- truncated at 32 KB (212 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lex-machina/refs/heads/main/openapi/lex-machina-list-api-openapi.yml