---
title: "Query State Cases"
method: POST
path: "/query-state-cases"
tags: ["Case Query", "State Cases"]
---

# Query State Cases

`POST /query-state-cases`

Queries enhanced state court cases.

- **data**: the state case query

See [https://developer.lexmachina.com/posts/query/state_query_usage/](https://developer.lexmachina.com/posts/query/state_query_usage/) for query formation.

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

## Request body

- StateCaseQuery
  - `courts` StateCourtFilter, required
    - `state` string, required
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `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
  - `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
  - `resolutions` ResolutionsFilter
    - `include` IndividualResolutionsFilter[], nullable
      - `summary` string, nullable
      - `specific` string, nullable
    - `exclude` IndividualResolutionsFilter[], nullable
      - `summary` string, nullable
      - `specific` string, nullable
  - `damages` IndividualStateDamagesFilter[], nullable
    - `name` NameFilter
      - `include` string[], nullable
      - `exclude` string[], nullable
    - `date` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `awardedToParties` integer[], nullable
    - `awardedAgainstParties` integer[], nullable
    - `minimumAmount` union
      - number
      - string
  - `rulings` IndividualRulingsFilter[], nullable
    - `judgmentEvent` JudgmentEventFilter
      - `include` string[], nullable
      - `exclude` string[], nullable
    - `awardedToParties` integer[], nullable
    - `awardedAgainstParties` integer[], nullable
    - `date` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
  - `ordering` 'ByFirstFiled' | 'ByLastFiled'
  - `page` integer
  - `pageSize` integer

## Response `200`

Success

- StateCaseQueryResult
  - `cases` StateCaseReference[], required
    - `url` string, required
    - `stateCaseId` 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)