---
title: "Query District Cases"
method: POST
path: "/query-district-cases"
tags: ["Federal District Cases", "Case Query"]
---

# Query District Cases

`POST /query-district-cases`

Queries federal district court cases.

- **data**: the district case query

See [Querying district cases](https://developer.lexmachina.com/api-reference/district-cases/querying-district-cases/) for documentation.

The results will contain a list of cases, each with a specificed url and Lex Machina districtCaseId.

## Request body

- DistrictCaseQuery
  - `caseStatus` 'Open' | 'Terminated'
  - `caseTypes` CaseTypesFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `caseTags` CaseTagsFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `dates` CaseDatesFilter
    - `filed` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `terminated` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `trial` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `lastDocket` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
  - `judges` JudgeFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
  - `magistrates` MagistrateFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
  - `events` EventFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `lawFirms` LawFirmFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
    - `includePlaintiff` integer[], nullable
    - `excludePlaintiff` integer[], nullable
    - `includeDefendant` integer[], nullable
    - `excludeDefendant` integer[], nullable
    - `includeThirdParty` integer[], nullable
    - `excludeThirdParty` integer[], nullable
  - `attorneys` AttorneyFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
    - `includePlaintiff` integer[], nullable
    - `excludePlaintiff` integer[], nullable
    - `includeDefendant` integer[], nullable
    - `excludeDefendant` integer[], nullable
    - `includeThirdParty` integer[], nullable
    - `excludeThirdParty` integer[], nullable
  - `parties` PartyFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
    - `includePlaintiff` integer[], nullable
    - `excludePlaintiff` integer[], nullable
    - `includeDefendant` integer[], nullable
    - `excludeDefendant` integer[], nullable
    - `includeThirdParty` integer[], nullable
    - `excludeThirdParty` integer[], nullable
  - `courts` CourtFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `resolutions` ResolutionsFilter
    - `include` IndividualResolutionsFilter[], nullable
      - `summary` string, nullable
      - `specific` string, nullable
    - `exclude` IndividualResolutionsFilter[], nullable
      - `summary` string, nullable
      - `specific` string, nullable
  - `findings` IndividualFindingsFilter[], nullable
    - `judgmentSource` JudgmentSourceFilter
      - `include` string[], nullable
      - `exclude` string[], nullable
    - `nameType` NameTypeFilter
      - `include` IndividualNameTypeFilter[], nullable
        - `name` string, nullable
        - `type` string, nullable
      - `exclude` IndividualNameTypeFilter[], nullable
        - `name` string, nullable
        - `type` string, nullable
    - `date` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `awardedToParties` integer[], nullable
    - `awardedAgainstParties` integer[], nullable
    - `patentInvalidityReasons` PatentInvalidityReasonsFilter
      - `include` string[], nullable
  - `remedies` IndividualRemediesFilter[], nullable
    - `judgmentSource` JudgmentSourceFilter
      - `include` string[], nullable
      - `exclude` string[], nullable
    - `nameType` NameTypeFilter
      - `include` IndividualNameTypeFilter[], nullable
        - `name` string, nullable
        - `type` string, nullable
      - `exclude` IndividualNameTypeFilter[], nullable
        - `name` string, nullable
        - `type` string, nullable
    - `date` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `awardedToParties` integer[], nullable
    - `awardedAgainstParties` integer[], nullable
  - `damages` IndividualDamagesFilter[], nullable
    - `judgmentSource` JudgmentSourceFilter
      - `include` string[], nullable
      - `exclude` string[], nullable
    - `nameType` NameTypeFilter
      - `include` IndividualNameTypeFilter[], nullable
        - `name` string, nullable
        - `type` string, nullable
      - `exclude` IndividualNameTypeFilter[], nullable
        - `name` string, nullable
        - `type` string, nullable
    - `date` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `awardedToParties` integer[], nullable
    - `awardedAgainstParties` integer[], nullable
    - `minimumAmount` union
      - number
      - string
  - `patents` PatentFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `mdl` MultidistrictLitigationFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
  - `appellateDecisions` AppellateDecisionFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `ordering` 'ByFirstFiled' | 'ByLastFiled'
  - `page` integer
  - `pageSize` integer

## Response `200`

Success

- DistrictCaseQueryResult
  - `cases` DistrictCaseReference[], required
    - `url` string, required
    - `districtCaseId` integer, 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)