---
title: "Get District Case"
method: GET
path: "/district-cases/{district_case_id}"
tags: ["Federal District Cases"]
---

# Get District Case

`GET /district-cases/{district_case_id}`

Gets data for a single federal district case.

- **district_case_id**: the Lex Machina districtCaseId
- **docket_retrieval**: docket retreival mode

## Path parameters

- `district_case_id` integer, required

## Query parameters

- `docket_retrieval` string, nullable — 'all' to retrieve docket entries for the case, if not provided no docket entries will be retrieved.

## Response `200`

Success

- DistrictCaseData — A single case from a federal district court case and relevant metadata.
  - `districtCaseId` integer, required
  - `title` string, required
  - `court` string, required
  - `caseNo` string, required
  - `status` 'Open' | 'Terminated', required
  - `caseType` string[], required
  - `caseTags` string[], required
  - `dates` DistrictCaseDates, required
    - `filed` string, date, required
    - `terminated` string, date, nullable
    - `trial` string, date, nullable, required
    - `lastDocket` string, date, nullable, required
  - `resolution` DistrictCaseResolution
    - `summary` string, required
    - `specific` string, required
    - `docketEntryFiled` string, date, nullable, required
    - `docketEntryId` integer, required
  - `events` CaseEvent[], required
    - `type` string, required
    - `occurred` string, date, required
  - `judges` FederalJudge[], required
    - `name` string, required
    - `federalJudgeId` integer, required
  - `magistrateJudges` MagistrateJudge[], required
    - `name` string, required
    - `magistrateJudgeId` integer, required
  - `remedies` DistrictCaseRemediesByStatus, required
    - `active` DistrictCaseRemedy[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `awardedToPartyIds` integer[], required
      - `againstPartyIds` integer[], required
      - `docketEntryFiled` string, date, required
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
    - `voided` DistrictCaseRemedy[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `awardedToPartyIds` integer[], required
      - `againstPartyIds` integer[], required
      - `docketEntryFiled` string, date, required
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
    - `reversed` DistrictCaseRemedy[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `awardedToPartyIds` integer[], required
      - `againstPartyIds` integer[], required
      - `docketEntryFiled` string, date, required
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
  - `findings` DistrictCaseFindingsByStatus, required
    - `active` DistrictCaseFinding[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `inFavorOfPartyIds` integer[], required
      - `patentInvalidityReasons` string[], required — Use 'specificReasons' instead
      - `againstPartyIds` integer[], required
      - `docketEntryFiled` string, date, required
      - `specificReasons` string[]
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
    - `voided` DistrictCaseFinding[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `inFavorOfPartyIds` integer[], required
      - `patentInvalidityReasons` string[], required — Use 'specificReasons' instead
      - `againstPartyIds` integer[], required
      - `docketEntryFiled` string, date, required
      - `specificReasons` string[]
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
    - `reversed` DistrictCaseFinding[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `inFavorOfPartyIds` integer[], required
      - `patentInvalidityReasons` string[], required — Use 'specificReasons' instead
      - `againstPartyIds` integer[], required
      - `docketEntryFiled` string, date, required
      - `specificReasons` string[]
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
  - `lawFirms` LawFirm[], required
    - `name` string, required
    - `lawFirmId` integer, required
    - `clientPartyIds` integer[], required
  - `attorneys` Attorney[], required
    - `name` string, required
    - `attorneyId` integer, required
    - `lawFirmIds` integer[], required
    - `clientsPartyIds` integer[], required
  - `parties` Party[], required
    - `name` string, required
    - `partyId` integer, required
    - `role` string, required
  - `damages` DistrictCaseDamagesByStatus, required
    - `active` DistrictCaseDamages[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `awardedToPartyIds` integer[], required
      - `awardedAgainstPartyIds` integer[], required
      - `amount` union, required
        - 'NotSpecified'
        - string
        - MassCounterfeiterDefaultDamages
          - `amountPerDefendant` union, required
            - string
            - 'NotSpecified'
      - `awarded` string, date, required
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
    - `voided` DistrictCaseDamages[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `awardedToPartyIds` integer[], required
      - `awardedAgainstPartyIds` integer[], required
      - `amount` union, required
        - 'NotSpecified'
        - string
        - MassCounterfeiterDefaultDamages
          - `amountPerDefendant` union, required
            - string
            - 'NotSpecified'
      - `awarded` string, date, required
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
    - `reversed` DistrictCaseDamages[], required
      - `name` string, required
      - `type` string, required
      - `judgmentSource` string, required
      - `awardedToPartyIds` integer[], required
      - `awardedAgainstPartyIds` integer[], required
      - `amount` union, required
        - 'NotSpecified'
        - string
        - MassCounterfeiterDefaultDamages
          - `amountPerDefendant` union, required
            - string
            - 'NotSpecified'
      - `awarded` string, date, required
      - `negated` string, date, nullable
      - `reinstated` string, date, nullable
      - `docketEntryId` integer, required
      - `negatedDocketEntryId` integer, nullable
      - `reinstatedDocketEntryId` integer, nullable
  - `patents` Patent[], required
    - `number` string, required
    - `title` string, nullable
  - `orders` Orders, required
    - `expertWitnessesAdmissibilityOrders` ExpertWitnessesAdmissibilityOrderByStatus, required
      - `active` ExpertWitnessAdmissibilityOrder[], required
        - `expertWitness` ExpertWitness, required
          - `name` string, required
          - `expertWitnessId` integer, required
        - `retainingPartyIds` integer[], required
        - `opposingPartyIds` integer[], required
        - `judge` union
          - FederalJudge
            - `name` string, required
            - `federalJudgeId` integer, required
          - MagistrateJudge
            - `name` string, required
            - `magistrateJudgeId` integer, required
        - `docketEntryFiled` string, date, nullable
        - `outcome` string, required
        - `occurred` string, date, required
        - `negated` string, date, nullable
        - `reinstated` string, date, nullable
      - `voided` ExpertWitnessAdmissibilityOrder[], required
        - `expertWitness` ExpertWitness, required
          - `name` string, required
          - `expertWitnessId` integer, required
        - `retainingPartyIds` integer[], required
        - `opposingPartyIds` integer[], required
        - `judge` union
          - FederalJudge
            - `name` string, required
            - `federalJudgeId` integer, required
          - MagistrateJudge
            - `name` string, required
            - `magistrateJudgeId` integer, required
        - `docketEntryFiled` string, date, nullable
        - `outcome` string, required
        - `occurred` string, date, required
        - `negated` string, date, nullable
        - `reinstated` string, date, nullable
      - `reversed` ExpertWitnessAdmissibilityOrder[], required
        - `expertWitness` ExpertWitness, required
          - `name` string, required
          - `expertWitnessId` integer, required
        - `retainingPartyIds` integer[], required
        - `opposingPartyIds` integer[], required
        - `judge` union
          - FederalJudge
            - `name` string, required
            - `federalJudgeId` integer, required
          - MagistrateJudge
            - `name` string, required
            - `magistrateJudgeId` integer, required
        - `docketEntryFiled` string, date, nullable
        - `outcome` string, required
        - `occurred` string, date, required
        - `negated` string, date, nullable
        - `reinstated` string, date, nullable
  - `mdl` MultiDistrictLitigation, required
    - `mdlNo` integer[], required
    - `masterCaseIds` integer[], required
    - `truncatedData` boolean, required
  - `appealsCases` AppealsCase[], required
    - `appealsCaseId` integer, required
    - `appealsCaseUrl` string, required
    - `resolution` DistrictCaseResolution
      - `summary` string, required
      - `specific` string, required
      - `docketEntryFiled` string, date, nullable, required
      - `docketEntryId` integer, required
    - `filedOn` string, date, required
    - `terminated` string, date, nullable
  - `docket` Docket, required
    - `entries` DocketEntry[], required
      - `filedOn` string, date, nullable, required
      - `tags` string[], required
      - `text` string, nullable, required
      - `number` integer, nullable, required
      - `docketEntryId` integer, required
    - `retrieved` 'all' | 'none', required
    - `count` integer, required
  - `complaintSummary` ComplaintSummary, required — Complaint Summaries appear on District Court case pages and briefly describe the contents of case-originating complaints. This allows users to quickly review cases for relevant fact patterns. Summaries include specific complaint points such as the nature of the case, plaintiff and defendant information, alleged harm, and requested remedies. In collaboration with Lexis+ AI and CourtLink, Lex Machina utilizes a sophisticated AI large language model (LLM) to review complaints and draft the summaries.
    - `summary` string, required
    - `documentLawUrl` string, required
    - `summarized` string, date, nullable, required
  - `natureOfSuit` NatureOfSuit
    - `code` integer, required
    - `title` string, required

## Other responses

- `401` — Invalid or expired token
- `404` — Not found
- `422` — Error - 422

---

[API](https://skmtc.net/lexmachina/apis/lex-machina-api.md) · [All operations](https://skmtc.net/lexmachina/apis/lex-machina-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lexmachina/lex-machina-api/revisions/5f519a7078fc/schema)
