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

# Query Appeals Cases

`POST /query-appeals-cases`

Queries federal appeals court cases.

- **data**: the appeals case query

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

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

## Request body

- AppealsCaseQuery
  - `courts` CourtFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `caseStatus` 'Open' | 'Terminated'
  - `caseTags` CaseTagsFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `dates` AppealsCaseDatesFilter
    - `filed` TimingFilter
      - `onOrAfter` string, date, nullable
      - `onOrBefore` string, date, nullable
    - `terminated` 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
  - `lawFirms` AppealsLawFirmFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
    - `includeAppellant` integer[], nullable
    - `excludeAppellant` integer[], nullable
    - `includeAppellee` integer[], nullable
    - `excludeAppellee` integer[], nullable
    - `includeRespondent` integer[], nullable
    - `excludeRespondent` integer[], nullable
    - `includeThirdParty` integer[], nullable
    - `excludeThirdParty` integer[], nullable
    - `includePetitionerMovant` integer[], nullable
    - `excludePetitionerMovant` integer[], nullable
  - `attorneys` AppealsAttorneyFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
    - `includeAppellant` integer[], nullable
    - `excludeAppellant` integer[], nullable
    - `includeAppellee` integer[], nullable
    - `excludeAppellee` integer[], nullable
    - `includeRespondent` integer[], nullable
    - `excludeRespondent` integer[], nullable
    - `includeThirdParty` integer[], nullable
    - `excludeThirdParty` integer[], nullable
    - `includePetitionerMovant` integer[], nullable
    - `excludePetitionerMovant` integer[], nullable
  - `parties` AppealsPartyFilter
    - `include` integer[], nullable
    - `exclude` integer[], nullable
    - `includeAppellant` integer[], nullable
    - `excludeAppellant` integer[], nullable
    - `includeAppellee` integer[], nullable
    - `excludeAppellee` integer[], nullable
    - `includeRespondent` integer[], nullable
    - `excludeRespondent` integer[], nullable
    - `includeThirdParty` integer[], nullable
    - `excludeThirdParty` integer[], nullable
    - `includePetitionerMovant` integer[], nullable
    - `excludePetitionerMovant` integer[], nullable
  - `originatingVenues` OriginatingVenuesFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `originatingCases` OriginatingCasesFilter
    - `includeDistrictCaseIds` integer[], nullable
    - `excludeDistrictCaseIds` integer[], nullable
    - `includeOriginatingJudges` OriginatingJudgeFilter
      - `districtFederalJudges` JudgeFilter
        - `include` integer[], nullable
        - `exclude` integer[], nullable
    - `originatingDistrictCaseCriteria` OriginatingDistrictCaseFilter
      - `courts` CourtFilter
        - `include` string[], nullable
        - `exclude` string[], nullable
      - `caseTypes` OriginatingCaseTypesFilter
        - `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
  - `supremeCourtDecisions` SupremeCourtDecisionsFilter
    - `include` string[], nullable
    - `exclude` string[], nullable
  - `ordering` 'ByFirstFiled' | 'ByLastFiled'
  - `page` integer
  - `pageSize` integer

## Response `200`

Success

- AppealsCaseQueryResult
  - `cases` AppealsCaseReference[], required
    - `url` string, required
    - `appealsCaseId` 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)