---
title: "Analyze District Cases From Query"
method: POST
path: "/analyze-district-cases/from-query"
tags: ["Federal District Cases", "Analytics"]
---

# Analyze District Cases From Query

`POST /analyze-district-cases/from-query`

## Request body

- DistrictCaseAnalyticFromQuery
  - `analyticType` 'CaseCountByType' | 'PartyCountByRole' | 'LawFirmCountByRole', required
  - `districtCaseQuery` DistrictCaseQuery, required
    - `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

- CaseAnalyticResult
  - `totalCases` integer, required
  - `aggregation` union, required
    - CaseTypeAggregation
      - `data` CaseCountByType[], required
        - `caseType` string, required
        - `count` integer, required
    - PartyAggregation
      - `data` PartyCountByRole[], required
        - `partyId` integer, required
        - `partyName` string, required
        - `rolesAndCounts` CountsPerRole[], required
          - `role` string, required
          - `count` integer, required
    - LawFirmAggregation
      - `data` LawFirmCountByRole[], required
        - `lawFirmId` integer, required
        - `lawFirmName` string, required
        - `rolesAndCounts` CountsPerRole[], required
          - `role` string, required
          - `count` 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)