Lex Machina Entities API

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